A production-ready monorepo for building modern web applications with accessible UI components, high-performance styling utilities, and shared development tooling.

• Introduction
• Architecture
• Packages
• Getting Started
  • Use in Your Project
  • Develop Locally
• Scripts
• Technologies
• Contributing
• Security
• Code of Conduct
• Support
• License

CodeFast is a monorepo containing a production-ready UI component library and supporting tools for building modern web applications. The core package, @codefast/ui, provides 62 accessible components built on Radix UI primitives, styled with Tailwind CSS 4, and fully typed with TypeScript.

Key highlights:

• Reusability — Versatile UI components that work across multiple projects.
• Flexible Customization — Override or extend default styles with Tailwind Variants.
• High Performance — Optimized for fast loading and minimal bundle size.
• Clear Codebase — Modern, readable, and easy-to-maintain structure.

graph TD
  subgraph apps [Apps]
    Web["@apps/ui<br/>Component showcase"]
  end

  subgraph packages [Packages]
    UI["@codefast/ui<br/>62 UI components"]
    TV["@codefast/tailwind-variants<br/>Variant styling API"]
    Theme["@codefast/theme<br/>Theme management"]
    DI["@codefast/di<br/>Dependency injection"]
    CLI["@codefast/cli<br/>Developer CLI"]
    TSConfig["@codefast/typescript-config<br/>TypeScript presets"]
  end

  Web --> UI
  Web --> Theme
  UI --> TV
  CLI --> DI
  UI -.->|dev dependency| TSConfig
  CLI -.->|dev dependency| TSConfig
  DI -.->|dev dependency| TSConfig
  Theme -.->|dev dependency| TSConfig

Install the UI component library:

pnpm add @codefast/ui

Import the required CSS and start using components:

import "@codefast/ui/css/style.css";
import { Button } from "@codefast/ui";

export default function App() {
  return <Button variant="outline">Click me</Button>;
}

See the individual package READMEs for detailed installation and usage instructions.

• Node.js >= 24.0.0
• pnpm 10.33.0

# Clone the repository
git clone https://github.com/codefastlabs/codefast.git
cd codefast

# Install dependencies
pnpm install

# Build all packages (required before running apps)
pnpm build:packages

# Start all apps and packages in dev mode
pnpm dev

# Or start a specific package
pnpm dev --filter=@codefast/ui

Contributions are welcome! Here's how to get started:

1. Fork the repository.
2. Clone your fork locally:

   git clone https://github.com/<your-username>/codefast.git

3. Install dependencies:

   pnpm install

4. Create a feature branch:

   git checkout -b feat/my-feature

5. Make your changes and add tests where applicable. Before committing, run pnpm build:packages (needed for type-aware Oxlint), then pnpm lint, pnpm format:check, and pnpm test from the repo root.
   • For internal imports in apps/packages, use Node subpath imports via package.json#imports (for example #components/button).
   • Avoid compilerOptions.paths in tsconfig for internal aliases; reserve TS path mapping only for external compatibility requirements.
6. Commit your changes following Conventional Commits:

   git commit -m "feat: add new component"

7. Push to your branch and open a Pull Request.

Please check the open issues for ideas on where to contribute.

If you discover a security vulnerability, please report it responsibly. Do not open a public issue. Instead, email the maintainers or use GitHub's private vulnerability reporting.

This project follows the Contributor Covenant Code of Conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior via GitHub Issues.

• Bug Reports: Open an issue
• Feature Requests: Open an issue
• Discussions: GitHub Discussions

This project is licensed under the MIT License.