create-tomoro-app

Create fullstack applications with a single command.

🚀 Quick Start

npx create-tomoro-app my-app

This will:

1. Download the React + FastAPI template
2. Install dependencies
3. Optionally run the interactive setup to configure everything

🔒 Security & Access

Note: This tool uses a private template repository (tomoro-ai/fullstack-template). Access is restricted to:

• Tomoro AI team members
• Authorized partners and clients
• Users with explicit repository access

If you encounter authentication errors when running this tool, please:

1. Ensure you have access to the tomoro-ai/fullstack-template repository
2. Authenticate with GitHub CLI: gh auth login
3. Contact your Tomoro AI team lead if you need repository access

📋 Available Template

React + FastAPI + PostgreSQL (Neon)

• React 18 with TypeScript and Vite
• FastAPI backend with async SQLAlchemy
• PostgreSQL database (Neon)
• Clerk authentication
• Google Cloud Platform deployment
• GitHub Actions CI/CD

💻 Usage

Basic Usage

npx create-tomoro-app my-app

Options

# Skip git initialization
npx create-tomoro-app my-app --no-git

# Skip dependency installation
npx create-tomoro-app my-app --no-install

# Skip setup script
npx create-tomoro-app my-app --no-setup

🛠 What Gets Created

my-app/
├── services/
│   ├── backend/          # FastAPI backend
│   └── frontend/         # React frontend
├── scripts/
│   ├── setup.sh         # Interactive setup script
│   └── setup-env.sh     # Environment file setup
├── docker-compose.yml    # Local development
├── package.json         # Root scripts
└── README.md           # Documentation

📚 After Creation

cd my-app

# Run interactive setup to configure everything (if skipped)
pnpm run setup

# Start development
pnpm dev

The setup script (pnpm run setup) will help you:

• Create required accounts (GCP, Clerk, Neon, OpenAI)
• Configure GitHub repository and secrets
• Set up Google Cloud Platform project
• Configure authentication and database
• Deploy your app to the cloud
• Start local development

📄 License

MIT

🔗 Links

• GitHub
• Template Documentation

Built with ❤️ by Darryl Wong @Tomoro AI