🤖 create-ai-project

Create production-ready projects with AI-powered GitHub Actions automation in seconds.

🎯 What is this?

create-ai-project is an NPM package that scaffolds projects with built-in AI automation. Write an issue, get a Pull Request with working code - automatically!

✨ Features

• 🤖 AI-Powered Development - Claude AI automatically implements features from GitHub issues
• 🚀 Multiple Templates - React Native, Next.js, Express, FastAPI, and more
• ⚡ Zero Configuration - Works out of the box with sensible defaults
• 🔧 Fully Customizable - Adjust AI behavior, prompts, and workflows
• 📦 Production Ready - Includes CI/CD, testing, and linting
• 🛡️ Self-Healing Workflows - Automatic error recovery and retry mechanisms (NEW in v1.1.0)

📦 Quick Start

# Using npx (recommended)
npx create-ai-project my-app

# Or with npm
npm create ai-project my-app

# Or install globally
npm install -g create-ai-project
create-ai-project my-app

🎨 Templates

Choose from multiple project templates:

• 📱 React Native (Expo) - Mobile app with TypeScript
• ⚛️ Next.js - Full-stack React framework with App Router
• 🚀 Express.js - Node.js backend API
• 🐍 FastAPI - Modern Python backend
• ⚡ Vite + React - Lightning-fast frontend development

🤖 How AI Automation Works

1. Create an Issue - Describe what you want to build
2. Add task label - This triggers the AI workflow
3. Wait ~1-2 minutes - AI analyzes and generates code
4. Review the PR - AI creates a pull request with working code
5. Merge! - Your feature is ready

Example Issue

Title: Create user authentication API

Description:
Implement JWT-based authentication with the following endpoints:
- POST /auth/register - Register new user
- POST /auth/login - Login and get token
- GET /auth/me - Get current user (protected)

Requirements:
- Use bcrypt for password hashing
- Return JWT tokens
- Add input validation
- Include error handling
- Write tests

AI will generate:

• ✅ Complete working code
• ✅ Tests
• ✅ Documentation
• ✅ Type definitions
• ✅ Error handling

🔧 Setup

1. Create your project

npx create-ai-project my-app
cd my-app

2. Push to GitHub

git remote add origin <your-repo-url>
git push -u origin main

3. Get Anthropic API Key

1. Visit console.anthropic.com
2. Sign up / Login
3. Go to API Keys → Create Key
4. Copy the key

4. Add to GitHub Secrets

1. Go to your repository on GitHub
2. Settings → Secrets and variables → Actions
3. Click New repository secret
4. Name: ANTHROPIC_API_KEY
5. Secret: Paste your API key
6. Click Add secret

5. Create your first AI-powered task!

1. Go to Issues → New issue
2. Write a detailed description
3. Add the task label
4. Submit and watch the magic! ✨

📚 Documentation

Detailed documentation is included in every project:

• docs/AI_SETUP.md - AI configuration and usage
• docs/GITHUB_SETUP.md - GitHub Actions setup
• docs/DEVELOPMENT.md - Development guide
• docs/AUTO_RECOVERY.md - Self-healing mechanisms and auto-recovery (NEW in v1.1.0)

🛡️ Self-Healing Features (v1.1.0)

The workflow now includes automatic error recovery:

• ✅ Auto-generates missing files - package-lock.json, requirements.txt, scripts
• ✅ Retry mechanisms - AI processing and git push operations retry automatically
• ✅ Graceful degradation - Workflow continues even when some steps fail
• ✅ Smart error handling - Non-blocking errors with detailed logging

See docs/AUTO_RECOVERY.md for details.

🎯 CLI Options

# Interactive mode (recommended)
npx create-ai-project

# Specify project name
npx create-ai-project my-app

# Choose template
npx create-ai-project my-app --template nextjs

# Skip dependency installation
npx create-ai-project my-app --no-install

# Skip git initialization
npx create-ai-project my-app --no-git

🔧 Configuration

Each project includes an ai-config.yaml file for customization:

project:
  name: my-app
  type: nextjs
  typescript: true

ai:
  model: claude-sonnet-4-20250514
  temperature: 0
  max_tokens: 8000

conventions:
  style: typescript
  testing: jest
  linting: eslint

💡 Examples

React Native Mobile App

npx create-ai-project my-mobile-app --template react-native

Next.js Web App

npx create-ai-project my-web-app --template nextjs

Express API

npx create-ai-project my-api --template express

Python API

npx create-ai-project my-python-api --template fastapi

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT © Egemen Kayalidere

🙏 Acknowledgments

• Powered by Anthropic Claude
• Inspired by create-react-app and create-next-app
• Built with love for developers who love AI

🌟 Show your support

Give a ⭐️ if this project helped you!

Made with 🤖 and ❤️ by developers, for developers