Help
Questions and answers
Short answers to what people ask most when they start with the kit. Each one links to the page with the details.
On this page
Setup#
Do I need Astro?
No. Components are React files with Tailwind 4. aiw new creates an Astro project, and the kit is also tested in Next.js and Vite.
InstallationDoes it work without Tailwind?
The components are built with Tailwind 4 and read their colors from the tokens in kit.css. Tailwind belongs in the project for that reason.
Include kit.cssDo I need the CLI?
Not for Copy & Paste. The CLI resolves dependencies, records versions and connects your AI assistant, which saves a lot of handwork with several components.
The aiw CLIDo I need an AI assistant?
No. Every component works without AI. An assistant such as Claude, Cursor, GitHub Copilot or Codex is a fast way to build whole pages from components.
Build with AI assistantsChoosing components#
Which components do I need for my website?
The guide names a proven selection for ten common kinds of websites, from the SaaS landing page to the medical practice, the shop and the creator page.
What is in the kitWhich component for a request form?
For a short message contact is enough. For quotes take request-quote, for appointments booking-request, for calls callback-request and for longer requests multi-step-form.
FormsWhich chart fits my numbers?
A change over time becomes a line, a comparison of categories a bar, the way from a start to an end value a waterfall and one value against its scale a gauge.
ChartsScroll story or scroll effect?
A scroll story tells across several screens and carries the most important message of a page. A scroll effect is short and makes a transition or a headline memorable.
Scroll storiesWhich component for an AI chat on my website?
chat-widget sits as a button in the corner of every page and hands over to your team. ai-chat is the full chat window for an app.
AI interfacesWorking with components#
May I change components?
Yes. Every component sits in your project as source and is yours. Small changes go through className, anything more right in the file.
Make it yoursMay I use the components in client projects?
Yes. The kit and the CLI are released under the MIT license. Use the components freely in your own projects and for clients, commercial ones included, the license notice stays with the code.
LicensesDoes an update overwrite my changes?
No. aiw update spots changed files through the lockfile and leaves them as they are. Only --force replaces them as well.
Versions and updatesDoes the page work without JavaScript?
Yes. Components render fully on the server and every piece of content is readable. JavaScript adds motion and interaction.
AccessibilityHow do I find the right variant?
The page of each category shows every variant with a live preview at three widths. In the terminal, aiw components <category> shows the same with the install line.
ComponentsLook and language#
Is there a light mode?
Yes. Without a class everything is light, class="dark" on the html element switches to dark. The kit starts dark, both modes are designed with the same care.
Dark mode as the defaultCan I use my brand color?
Yes. aiw theme turns your color into an accent for light and dark, by hand it is two tokens per mode.
Your own brand colorWhich languages are built in?
English and German for every text a component writes itself. Pass any other language through labels. Your content always comes through props.
Language and labelsWhere do icons and type come from?
The icons are drawn for the kit. The typeface is SF Pro Display on Apple devices and Inter everywhere else, self-hosted.
Icons