allspark_rails - The AI-First Rails Template

Build production Rails apps in hours, not months. Perfect for vibe coding.

Part of the AllSpark template family: Rails | Django | Next.js | More →

Live Demo | Documentation | AllSpark Builder

🚀 Start Building in 60 Seconds

# One command to start
git clone https://github.com/TanookiLabs/allspark_rails.git my-app
cd my-app && ./setup.sh

# Or manually:
cp .env.example .env
docker-compose up -d
docker-compose exec web rails db:setup

# ✅ You're running! Visit http://localhost:3000
# Default login: [email protected] / password123

🤖 Why Creators Choose allspark_rails

For Solo Creators

• 10x faster development with AI-optimized structure
• Production-ready from day one
• No configuration needed

For Creative Teams

• Consistent patterns across all projects
• Built-in best practices from 12 years of agency work
• Scalable architecture that grows with you

For AI-Powered Creators

• Perfect for Claude, Cursor, Copilot
• Structured for AI understanding
• Rich context and documentation

✨ What's Included

🎯 Core Features

• 🔐 Authentication & Authorization - Devise + Pundit, user impersonation, JWT ready
• 🤖 AI Integration - OpenRouter (100+ models), OpenAI, Claude, Gemini support
• 📝 App Project Builder - AI generates PRDs and task lists from your requirements
• 💬 Real-time Chat - ActionCable-powered with typing indicators and read receipts
• 📚 Knowledge Base - RAG-enabled document management system
• 🔄 Visual Workflows - Drag-and-drop workflow builder
• ⚡ Background Jobs - Sidekiq with monitoring dashboard
• 🎨 Beautiful UI - 30+ DaisyUI components, fully responsive

🛠 Developer Experience

• Smart Generators - rails g ai_model, rails g ui_component, rails g service
• Self-Healing Tests - Browser tests that diagnose and suggest fixes
• Docker Development - Zero-config development environment
• AI-Optimized Docs - CLAUDE.md with patterns and conventions
• Quality Tools - RuboCop, Brakeman, bundler-audit pre-configured

🔑 AI Configuration

Option 1: OpenRouter (Recommended - One Key for Everything)

# Sign up at https://openrouter.ai
OPENROUTER_API_KEY=sk-or-v1-your-key-here
LLM_PROVIDER=openrouter

Access to GPT-4, Claude 3.5, Gemini, and 100+ more models with pay-per-use pricing.

Option 2: Direct Provider Keys

# Choose your provider
LLM_PROVIDER=openai      # or 'anthropic' or 'gemini'

# Add corresponding key
OPENAI_API_KEY=sk-...    # For OpenAI/GPT models
ANTHROPIC_API_KEY=sk-ant-... # For Anthropic/Claude models  
GEMINI_API_KEY=...        # For Google/Gemini models

💻 AI Agent Quick Reference

All commands run inside Docker containers:

# Generate complete features
docker-compose exec web rails g scaffold Task title:string status:string
docker-compose exec web rails db:migrate

# Create UI components
docker-compose exec web rails g ui_component alert --variants=success,error,warning

# Add service objects  
docker-compose exec web rails g service payment_processor

# AI-enhanced models
docker-compose exec web rails g ai_model product --description="E-commerce product"

# View component library
# Visit http://localhost:3000/lookbook

📁 Project Structure

my-app/
├── .allspark/          # Template metadata and configuration
├── app/
│   ├── components/     # ViewComponents with DaisyUI
│   ├── services/       # Business logic services
│   └── channels/       # Real-time features
├── docs/
│   ├── getting-started/ # Installation and setup
│   ├── features/       # Feature documentation
│   └── guides/         # Development guides
└── CLAUDE.md          # AI assistant instructions

🚀 Deployment

One-Click Deployment

• Heroku: Deploy button in repository
• Railway: Connect GitHub repo
• Render: Auto-deploy from GitHub

Manual Deployment

# Docker (any VPS)
docker build -t myapp .
docker run -p 3000:3000 myapp

# DigitalOcean with Kamal
./deploy-to-digitalocean.sh

🎯 Who Are the Creators Using allspark_rails?

• Indie Creators building their next SaaS
• Agency Creators delivering client projects faster
• Startup Creators launching MVPs in days
• Enterprise Creators prototyping new ideas

📚 Documentation

• Getting Started - Setup and installation
• Features Guide - All features explained
• AI Integration - LLM setup and usage
• Deployment Guide - Production deployment
• CLAUDE.md - AI assistant instructions

🚀 Want More Power?

AllSpark Builder - Where creators build production apps

• Visual project planning
• One-click deployment
• Team collaboration
• Enterprise features

Start Building on AllSpark →

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

• 🐛 Report bugs
• 💡 Request features
• 💬 Join Discord
• 🔧 PRs welcome!

📊 Stats

📄 License

MIT License - see LICENSE for details

---

Built with ❤️ by creators, for creators

Ready to build something amazing? Start with the Quick Start above or explore the complete documentation.