Configuration
ForgeUI uses a forgeui.config.ts file in your project root to manage settings.
Default Configuration
typescript
// forgeui.config.ts
import { defineConfig } from "forgeui";
export default defineConfig({
// Where components are installed
componentDir: "./src/components/ui",
// Utility helper location
utilsPath: "./src/lib/utils",
// Active theme preset
theme: "modern",
// TypeScript support
typescript: true,
// Tailwind CSS version
tailwind: "v4",
// Include animations by default
animations: true,
// Default icon library
icons: "lucide-react",
});Configuration Options
| Option | Type | Default | Description |
|---|---|---|---|
componentDir | string | "./src/components/ui" | Directory where components are installed |
utilsPath | string | "./src/lib/utils" | Path to the cn() utility |
theme | string | "modern" | Active color theme preset |
typescript | boolean | true | Generate TypeScript or JavaScript |
tailwind | string | "v4" | Tailwind CSS version |
animations | boolean | true | Include Framer Motion animations |
icons | string | "lucide-react" | Icon library to use |
Environment Variables
For the AI Generator feature, set your API key:
bash
# .env.local
FORGEUI_AI_KEY=your-api-key-here