ForgeKit Documentation
Dangerously easy project scaffolding. Launch production-ready apps in minutes with opinionated stacks and best practices.
⚡ Lightning Fast
Go from idea to deployed app in under 5 minutes. No configuration, no setup headaches.
✨ Opinionated
Curated tech stacks with sensible defaults. Focus on building, not configuring.
🌟 Deploy Ready
Built-in deployment to ForgeKit.ai hosting with automatic SSL and custom domains.
🔮 Production Ready
Security best practices, containerized deployments, and monitoring included.
Installation
Install ForgeKit globally using npm:
npm install -g @forgekit/cliOr use npx to run without installing:
npx @forgekit/cliRequirements
- • Node.js 18+ installed
- • npm or yarn package manager
- • Git for version control
Quick Start
1. Create a new project
forgeForgeKit will prompt you to choose your project name and stack options.
2. Choose your stack
ForgeKit will prompt you to select:
- • Frontend: React, Next.js, Vue, Svelte, Angular, Astro
- • Backend: Express, NestJS, FastAPI, Django, Rails, Go Fiber
- • UI Framework: Tailwind, Material-UI, Chakra UI, shadcn/ui
3. Start developing
cd your-project-name
npm run dev4. Deploy to production
forge login
forge deployYour app will be live at https://your-slug.forgekit.ai in minutes!
Available Stacks
Frontend Frameworks
Backend Frameworks
UI Frameworks
Deployment
Authentication
First, authenticate with ForgeKit.ai:
forge loginThis will open your browser to complete OAuth authentication.
Deploy Your App
forge deployForgeKit will automatically:
- • Build your application
- • Create a Docker container
- • Deploy to ForgeKit.ai infrastructure
- • Generate SSL certificates
- • Assign a random subdomain
Custom Domains
Available on Builder and Pro plans. Add a custom domain:
forge domain add example.comDNS Setup Required
You'll need to create a TXT record for domain verification and point your domain to our servers.
Environment Variables
Set environment variables for your deployment:
forge env set DATABASE_URL=postgresql://...
forge env set API_KEY=your-secret-keyPricing Plans
Free
"The Sandbox"Perfect for quick demos and experiments.
- • 1 active deploy
- • 0.25 vCPU / 512MB RAM
- • 512MB storage
- • Expires after 7 days
- • Random subdomain only
Builder
"Weekend Warrior"For indie hackers and side projects.
- • Up to 3 deploys
- • 1 vCPU / 1.25GB RAM per container
- • 2GB storage per deploy
- • No expiration
- • Custom domain support
- • Environment variables
- • Basic logs
Pro
"Prototyper Max"For serious builders and teams.
- • Up to 5 deploys
- • 1 vCPU / 1.25GB RAM per container
- • 2GB storage per deploy
- • No expiration
- • All Builder features
- • Full log access
- • Priority scheduling
- • GitHub triggers (coming soon)
CLI Reference
forgeforge loginforge deployforge listforge logs my-app-abc123forge delete my-app-abc123forge domain add example.comforge env set DATABASE_URL postgres://...forge whoamiforge logoutTroubleshooting
Deployment Failed
If your deployment fails, check the following:
- • Ensure your project has a valid
package.json - • Check that your build command works locally
- • Verify you have the necessary permissions
- • Check deployment logs with
forge logs <slug>
Authentication Issues
If you can't log in or deploy:
- • Try logging out and back in:
forge logout && forge login - • Check your internet connection
- • Ensure you have a ForgeKit.ai account
- • Clear your browser cache if OAuth fails
Resource Limits
If you hit resource limits:
- • Delete unused deployments with
forge delete <slug> - • Upgrade to Builder or Pro plan for more resources
- • Check your current usage in the dashboard