Creating Projects

Three Ways to Create a Project

Option 1: Start Fresh (AI-Powered Wizard)

The wizard guides you through project setup with AI assistance.

Step 1: Entry Choice

Choose "Start Fresh" to begin a new project from scratch.

Step 2: Intent

Describe your project idea. Examples:

• "A task management app for small teams"
• "An e-commerce site for selling handmade crafts"
• "A dashboard for tracking fitness goals"

The AI asks clarifying questions (2–3) about features, audience, and requirements.

Step 3: Architecture (Template Selection)

Choose a starting template:

• Next.js: Full-stack React with server-side rendering
• React SPA: Vite + React Router
• Node API: Express + OpenAPI
• Electron: Cross-platform desktop
• React Native: iOS & Android with Expo

Step 4: Stack

Select your technology stack:

• Backend: Supabase, Convex, Firebase, or custom
• Hosting: Vercel, Netlify, Railway, Fly.io
• AI Provider: OpenAI, Google, Anthropic (for AI features)

Step 5: Source Control

Configure Git:

• Provider: GitHub or GitLab
• Visibility: Private or Public
• Merge Strategy: Squash, Merge, or Rebase

Step 6: Visuals

Customize appearance:

• UI Library: shadcn, Chakra UI, Material UI
• Primary Color: Hex color picker
• Secondary and Accent Colors

Step 7: Team

Add team members (optional):

• Invite by email
• Assign roles: Project Manager, Developer, Designer, Viewer
• Can be skipped and done later

Step 8: Review

Review your configuration before generating the plan.

Step 9: Plan Generation

The AI generates three plan tiers:

• Prototype: Minimal features, fastest to build
• Beta: Core functionality complete, some polish
• MVP: Production-ready with all requested features

Each plan includes:

• Project name and description
• Feature list
• Estimated scope
• Page structure
• Database entities (if applicable)
• Technology choices

Select a plan to proceed.

Step 10: Build

After selecting a plan, the AI builds your project:

• Creates file structure
• Generates code
• Sets up dependencies
• Configures build tools
• Shows progress in real time

You can review changes before they're applied. Once building completes, your project is ready to use.

Option 2: Import from Repository

Import an existing project from GitHub or GitLab.

Process:

1. Click "Create New Project" → "Import Repository"
2. Connect GitHub or GitLab if needed (OAuth)
3. Select repository and branch
4. Choose a local folder
5. The app clones the repo and syncs it to cloud storage

What Gets Imported:

• All files and folders
• Git history (if available)
• Detected tech stack
• Project structure

After import, the project appears in your Projects list and is ready to use.

Option 3: Quick Prompt

Fastest way to start:

1. Click "Create New Project" → "Quick Prompt"
2. Describe what you want to build
3. The AI generates a plan immediately
4. Review and approve to start building

This skips the detailed wizard and uses sensible defaults.

Project Templates Explained

• Next.js: Full-stack React with SSR, API routes, and file-based routing. Good for: Web apps, dashboards, content sites.
• React SPA: Client-side React with Vite. Good for: Single-page apps, portfolios, simple web apps.
• Node API: Express-based REST API with OpenAPI. Good for: Backend services, APIs, microservices.
• Electron: Cross-platform desktop apps. Good for: Desktop applications, native-feel apps.
• React Native: Mobile apps for iOS and Android with Expo. Good for: Mobile apps, cross-platform mobile.