Build web-apps faster with built-in templates and guardrails so your AI can code faster.
MAXSTACK is a modern CLI tool that scaffolds full-stack React applications with AI-powered development workflows. It provides a carefully curated tech stack, pre-built templates, and intelligent code generation to help you ship faster.
Create a production-ready app in 3 commands:
npx maxstack init my-app # 🎨 Interactive project setup
cd my-app && npm install # 📦 Install dependencies
npm run dev # 🚀 Start developing- Generate components, routes, and schemas with
maxstack gen - AI-assisted code scaffolding and template creation
- Intelligent project structure and best practices
- Beautiful, accessible templates for common pages
- Blog, marketing, auth, and SaaS templates included
- Responsive design with Tailwind CSS and shadcn/ui components
- Full-stack TypeScript with React Router v7
- Database with Drizzle ORM and SQLite
- Authentication with Better Auth
- Email system with React Email
- End-to-end testing with Playwright
- One-click deployment to Fly.io
- Docker containerization included
- Automatic database migrations
- GitHub Actions CI/CD ready
MAXSTACK includes everything you need for modern web development:
| Category | Technology | Purpose |
|---|---|---|
| Frontend | React 19 + React Router v7 | Modern full-stack React with routing |
| Styling | Tailwind CSS + Radix UI | Utility-first CSS with accessible components |
| Backend | Node.js + TypeScript | Type-safe server-side development |
| Database | Drizzle ORM + SQLite | Type-safe database queries and migrations |
| Auth | Better Auth | Modern authentication with multiple providers |
| React Email + Resend | Templated emails with React components | |
| Testing | Vitest + Playwright | Unit, integration, and E2E testing |
| Code Quality | Biome + TypeScript | Fast linting, formatting, and type checking |
| Deployment | Fly.io + Docker | Production deployment with containers |
- Node.js 20.19.0 or higher
- npm, pnpm, or yarn
# Create a new MAXSTACK project
npx maxstack init my-awesome-app
# Navigate to your project
cd my-awesome-app
# Install dependencies
npm install
# Start the development server
npm run devYour app will be running at http://localhost:5173 with:
- ✅ Authentication system ready
- ✅ Database configured
- ✅ UI components available
- ✅ Testing setup complete
# Generate new components and features with AI
npx maxstack gen
# Examples of what you can generate:
# - Blog system with posts and categories
# - User dashboard with analytics
# - E-commerce product catalog
# - Contact forms and landing pagesEvery MAXSTACK project comes with these development commands:
npm run dev # Start development server
npm run build # Build for production
npm run start # Start production server
npm run test # Run unit tests with Vitest
npm run test:e2e # Run E2E tests with Playwright
npm run lint # Lint and format code with Biome
npm run typecheck # Type check with TypeScript
npm run validate # Run all checks (lint + test + typecheck)
npm run db:push # Push database schema changes
npm run db:studio # Open database admin interfaceMAXSTACK creates a well-organized project structure:
my-app/
├── app/ # Application code
│ ├── components/ # Reusable UI components
│ │ ├── templates/ # Page templates (blog, landing, etc.)
│ │ └── ui/ # Basic UI components (buttons, forms, etc.)
│ ├── routes/ # File-based routing with React Router
│ ├── services/ # Business logic and API calls
│ ├── hooks/ # Custom React hooks
│ └── utils/ # Utility functions
├── database/ # Database schema definitions
├── drizzle/ # Database migrations
├── e2e/ # End-to-end tests
├── public/ # Static assets
├── scripts/ # Build and deployment scripts
└── maxstack.tsx # Project configuration
MAXSTACK includes production-ready templates for common use cases:
# Generate a complete blog with posts, categories, and admin
npx maxstack init my-blog
# Select "Blog" when prompted for features- SEO-optimized blog posts
- Category and tag management
- Markdown content support
- Admin interface included
# Create a modern SaaS landing page
npx maxstack init my-saas
# Select "SaaS Marketing" when prompted- Landing page with hero section
- Pricing tables and feature grids
- Newsletter sign-up forms
- Customer testimonials
AI can know what to do when there are clear conventions, and included Agents.md file, and validation scripts.
Start with adding pages into maxstack.tsx, run npx maxstack gen, and you will have your pages, components, and tests stubbed out, ready for your AI assistant to fill things out.
- Getting Started Guide - Comprehensive tutorial
- API Reference - Complete API documentation
- Template Gallery - Browse all available templates
- Deployment Guide - Production deployment options
Deploy to Fly.io with one command:
npm run deployThis automatically:
- ✅ Builds your application
- ✅ Runs database migrations
- ✅ Deploys with zero downtime
- ✅ Sets up monitoring and health checks
Fill in the env variables requested in scripts/deploy-digitalocean.sh, and run it with pnpm run deploy:digitalocean
MAXSTACK works with any Node.js hosting platform and comes with an included Dockerfile:
-
Vercel:
npm run build && vercel deploy - Railway: Connect your GitHub repo
- AWS/GCP: Deploy with standard Node.js configuration
- Discord Community - Get help and share projects
- GitHub Discussions - Feature requests and Q&A
- [ ] More AI model integrations (Claude, Gemini)
- [ ] Advanced deployment options (Kubernetes, AWS)
- [ ] More Standard Features
- [ ] Advanced analytics dashboard
- [ ] Multi-tenant SaaS features
- Advanced AI Models: Access to GPT-4, Claude 3, and specialized code models
- Premium Templates: E-commerce, CRM, and enterprise applications
- Priority Support: Direct access to the MAXSTACK team
- Custom Integrations: Tailored solutions for your specific needs
Quick Demo: Create a todo app in 2 minutes
npx maxstack init todo-demo
cd todo-demo && npm install && npm run devMAXSTACK is MIT licensed. See LICENSE.md for details.
Contributing: We welcome contributions! See our Contributing Guide and Development Setup.
⭐ Star this repo if MAXSTACK helps you build faster!
Built with ❤️ by the MAXSTACK team
 Daniel Arrizza 💻 🖋 📖 🤔 🚇 🚧 📆 🔧 |
