talos design:create builds a front-end design system as a module in your project. It scaffolds a base module, takes it out of the backend wiring, marks it as a design module, then clones the upstream skeleton-design repository and copies its source (components, hooks, icons, fonts, styles, and utils) into your module. The result is a design system under modules/<name>/src/, ready to use, with its dependencies already installed.
A design module is not part of your backend. It is a self-contained UI layer that your SPA and other front-end code consume. For how it fits into the project, see the Design System overview.
Command
Module stripped, and the folder on disk uses kebab-case. If you omit --name, the command prompts for it.
Examples
Options
What happens
When you run the command, it works through these steps in order:- Scaffolds a base module under
modules/<kebab-name>/:package.json(named@module/<kebab>),tsconfig.json,<kebab>.yml, and the usual module files. - Un-registers it from
AppModuleandSharedModule. A design module is a front-end layer, not part of the backend, so it is removed from the backend module wiring. - Removes the scaffolded
<Pascal>Module.tsand its spec file, since a design module does not need a backend module class. - Marks the module as
type: "design"in its<kebab>.ymlconfig so the toolchain treats it as a design system. - Clones the upstream
skeleton-designrepository (https://github.com/ooneex/skeleton-design.git, a shallow clone) and copies itssrc/into the module’ssrc/. - Installs the design’s dependencies into your project:
dependenciesviabun addanddevDependenciesviabun add -D.
This command clones the design source over the network, so it needs
git
installed and an active internet connection.What you get
After the command finishes, you have a complete design system undermodules/<name>/src/, holding components, hooks, icons, fonts, styles, and utils, with every dependency already installed.
- Browse the generated layout in the structure reference.
- Start consuming it in your front-end code with the usage guide.
Use with Claude and Codex
The toolchain ships a matchingtalos:design skill. It guides your AI agent around the design system layout (where components, hooks, icons, fonts, styles, and utils live) so the agent can create the module and then work inside it correctly. Initialize the skills once for your agent:
- Claude
- Codex
Prompt
talos design:create --name=ui, then the agent can navigate the resulting design system using the talos:design skill.
See design:create for the full command reference.