FAQ
Frequently asked questions about TokenUI. Can't find what you're looking for? Reach out to us on Discord or GitHub.
General
TokenUI is a platform for discovering and sharing UI components and design patterns. It provides a curated collection of "skills" — reusable code snippets, components, and design tokens that help developers and AI agents build consistent interfaces.
TokenUI is designed for both developers and AI agents. Whether you're building a prototype, a production app, or using an AI coding assistant, TokenUI provides ready-to-use components that follow best practices.
Yes, all skills on TokenUI are free to use. The platform is open-source and community-driven. Some skills may have specific licenses (MIT, Apache 2.0, etc.) which are displayed on their detail pages.
Getting Started
No installation required for basic usage. You can use npx to run the CLI directly:
npx tokenui.sh add <skill-name>If you prefer, you can install the CLI globally with npm install -g tokenui.
TokenUI is built primarily for React applications using TypeScript and Tailwind CSS. Many skills will work with other setups, but the best experience is with:
- React 18+ with TypeScript
- Tailwind CSS for styling
- Any build tool (Vite, Next.js, Remix, etc.)
Browse the gallery, find a skill you like, and run:
npx tokenui.sh add <skill-name>The CLI will install the skill and all its dependencies to your project.
Skills & Components
A skill is a self-contained package that can include:
- React components with TypeScript
- Styling (Tailwind classes or CSS)
- Design tokens (colors, spacing, typography)
- Documentation and usage examples
- Required dependencies
Absolutely! Once installed, skills are just code in your project. You can modify them however you like. Most components use Tailwind classes for styling, making customization straightforward.
Yes. Skills can be adapted to match your design system. You can either:
- Customize the installed components directly
- Use CSS variables to override default styles
- Create wrapper components that match your system
Use the update command to get the latest version:
npx tokenui.sh update <skill-name>Or update all skills at once:
npx tokenui.sh update --allPublishing
Click the "Publish" button in the navigation, or run:
npx tokenui.sh publishFill out the form with your skill details, upload a preview screenshot, and submit. All submissions are reviewed before appearing in the gallery.
A great skill is:
- Focused — Does one thing well
- Documented — Clear usage instructions
- Accessible — Works with keyboard and screen readers
- Flexible — Easy to customize via props
- Tested — Works in common scenarios
Yes, you can save skills as drafts. They won't appear in the public gallery until you explicitly publish them. This is useful for iterating on your designs before sharing.
You retain ownership of your work. By publishing, you grant TokenUI users a license to use your skill according to the license you specify (MIT recommended). You can remove your skills from the gallery at any time.
AI & Agents
Yes! TokenUI is designed with AI agents in mind. The CLI provides structured output that agents can parse, and the skill format is designed to be machine-readable with clear dependencies and usage patterns.
When working with AI agents, you can reference TokenUI skills in your prompts:
"Create a login form using the tokenui form and button skills"
The agent can then use the CLI to install the appropriate skills.
TokenUI is platform-agnostic. It works with any AI coding assistant that can:
- Run terminal commands (Claude, GPT-4, Copilot, etc.)
- Read and write files
- Understand component-based architectures
Troubleshooting
First, ensure you have Node.js 18+ installed:
node --versionIf npx isn't working, try installing the CLI globally:
npm install -g tokenuiThen use tokenui directly without npx.
Common issues and solutions:
- Check your internet connection
- Verify the skill name is correct
- Use --verbose flag to see detailed error messages
- Try with --force to overwrite existing files
Ensure Tailwind CSS is properly configured in your project. Skills assume standard Tailwind utility classes are available. Check that your tailwind.config.js includes the paths to your component files.
For CLI bugs, open an issue on the TokenUI GitHub repository with:
- Your Node.js version
- The exact command you ran
- The error message (use --verbose)
- Your operating system
For skill-specific bugs, leave a comment on the skill's detail page.
Still have questions?
Join our community or reach out directly.