stera.config.json

Configuration reference for your Stera UI project.

stera.config.json is created by stera-ui init and tells the CLI where to put files and how to rewrite import paths.

Projects that ran init on an earlier release will have components.json. The CLI still reads that filename for now and prints a deprecation warning — run stera-ui init again or rename the file to silence it.

Schema

{
  "$schema": "https://ui.stera.sh/schema.json",
  "version": 1,
  "css": "src/styles/globals.css",
  "aliases": {
    "components": "@/components",
    "utils": "@/lib/utils",
    "ui": "@/components/ui",
    "lib": "@/lib",
    "hooks": "@/hooks"
  },
  "fonts": {
    "strategy": "stera-default"
  }
}

Options

`css`

Path to your main CSS file. stera-ui.css (design tokens) is created next to it.

`aliases`

Path aliases used when components are written to disk. Must match your tsconfig.json paths.

Alias	Default	Description
`components`	`@/components`	General components directory
`utils`	`@/lib/utils`	Path to the `cn()` utility
`ui`	`@/components/ui`	Where UI components are installed
`lib`	`@/lib`	Library directory
`hooks`	`@/hooks`	Custom React hooks

`fonts`

Records the font choice made during init. The CLI reads this on subsequent runs.

Field	Values	Description
`strategy`	`stera-default` \| `keep-existing` \| `skip`	How fonts were configured
`nextFont`	`boolean`	Whether `next/font` was wired up (Next.js only)

Imports inside component source are rewritten to match these aliases when you run stera-ui add.