Precast App

🚀 Build TypeScript projects with SUPERHUMAN SPEED!

Choose your stack, configure your powers, and launch into action!

Website • Builder • Documentation • Discord

---

✨ Features

• 🎯 Visual Builder - Configure your stack visually at precast.dev/builder
• 🎨 Multi-framework support - React, Vue, Angular, Next.js, Nuxt, Svelte, Solid, Remix, Astro, Vite, and Vanilla JS
• 🔧 Backend integration - Express, Fastify, Hono, NestJS, or Next.js API Routes
• 🗄️ Database setup - PostgreSQL, MySQL, MongoDB, SQLite with Prisma, Drizzle, or TypeORM
• 🔐 Authentication - Better Auth, NextAuth, Clerk, Supabase Auth, Auth0, Firebase Auth
• 💅 UI libraries - Shadcn/ui, DaisyUI, Material UI, Chakra UI, Ant Design, Mantine
• 🤖 AI Integration - Claude Code with MCP servers, GitHub Copilot configuration
• 📦 Smart package management - Automatic fallback handling for compatibility issues

🚀 Quick Start

Option 1: Visual Builder (Recommended)

Visit precast.dev/builder to visually configure your stack and copy the generated command.

Option 2: Command Line

# Interactive mode
npx create-precast-app@latest

# With options
npx create-precast-app my-app --framework react --backend express --database postgres

# Full configuration
npx create-precast-app my-app \
  --framework next \
  --backend express \
  --database postgres \
  --orm prisma \
  --styling tailwind \
  --ui-library shadcn \
  --auth better-auth \
  --install

📖 Commands

Command	Description	Documentation
init	Create a new project with your chosen stack	Docs
add	Add resources to existing project (component, route, api)	Docs
add-features	Add features to existing project (UI libs, AI context)	Docs
list	List available templates and features	Docs
banner	Create a banner template for customization	Docs

Examples

# Create a Next.js app with everything configured
npx create-precast-app my-nextjs-app \
  --framework next \
  --backend none \
  --database postgres \
  --orm prisma \
  --styling tailwind \
  --ui-library shadcn \
  --auth better-auth \
  --ai claude \
  --mcp-servers postgresql,github \
  --install

# Create a React + Express full-stack app
npx create-precast-app my-fullstack-app \
  --framework react \
  --backend express \
  --database postgres \
  --orm drizzle \
  --api-client tanstack-query \
  --install

# Add authentication to existing project
npx create-precast-app add-features \
  --auth better-auth \
  --provider github,google

🛠️ Available Options

Category	Options
Frontend Frameworks	react vue angular next nuxt svelte solid remix astro vite vanilla
Backend Frameworks	express fastify hono nest none
Databases	postgres mysql sqlite mongodb none
ORMs	prisma drizzle typeorm mongoose none
Styling	tailwind css scss css-modules styled-components emotion
UI Libraries	shadcn daisyui material-ui chakra-ui ant-design mantine
Authentication	better-auth next-auth clerk supabase-auth auth0 firebase-auth
AI Assistance	claude copilot none

📈 Star History

🎯 Why Precast?

• Zero Config - Sensible defaults that just work
• Production Ready - Best practices and security built-in
• Type Safe - Full TypeScript support across the stack
• Modern Stack - Latest versions of all dependencies
• AI Ready - Claude Code and GitHub Copilot pre-configured
• Fast Development - Hot reload, auto-completion, and more
• Extensible - Easy to customize and extend

📦 Repository Structure

precast-app/
├── packages/
│   ├── cli/                 # Main CLI tool (create-precast-app)
│   ├── website/             # Visual builder and documentation site
│   ├── ui/                  # Shared UI component library
│   ├── utils/               # Shared utilities
│   ├── hooks/               # Shared React hooks
│   └── shared/              # Shared configuration and types
├── .github/                 # GitHub workflows and templates
├── docs/                    # Project documentation
└── scripts/                 # Build and maintenance scripts

🔧 Development

# Clone the repository
git clone https://github.com/BuunGroupCore/precast-app.git

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run the website locally
pnpm dev

# Test the CLI locally
cd packages/cli && node dist/cli.js init test-project

Package Scripts

# Run tests
pnpm test

# Run linting
pnpm lint

# Run type checking
pnpm typecheck

# Format code
pnpm format

# Clean all builds
pnpm clean

🤝 Contributing

We love contributions! Please see our Contributing Guide for details.

How to Contribute

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Development Guidelines

• Write tests for new features
• Follow the existing code style
• Update documentation as needed
• Keep commits atomic and descriptive
• Ensure all tests pass before submitting PR

💖 Sponsors

A huge thank you to our sponsors who make this project possible!

Gold Sponsors

Become our first gold sponsor!

Silver Sponsors

Your company here

Bronze Sponsors

Support the project

📊 Stats

🌟 Showcase

Projects built with Precast:

• [Your Project Here] - Submit your project via PR!
• [Example App] - Full-stack demo application
• [Production Site] - Real-world production deployment

Submit your project to be featured here!

👥 Contributors

Thanks to all the amazing people who have contributed to this project!

📄 License

MIT © Buun Group

🚨 Security

For security issues, please email security@precast.dev instead of using the issue tracker.

🔗 Links

• Website
• Visual Builder
• Documentation
• GitHub
• npm Package
• Discord Community
• Twitter

---

Made with ❤️ by the Buun Group team

Try the Visual Builder →