2.3 Creating Your First Project

Creating your first project in VibeMap is where the magic happens! This is where your ideas transform into comprehensive, actionable development plans. The process is designed to be intuitive while providing powerful AI-driven project generation.

Before You Start

What You'll Need

• A clear project idea: Even a rough concept will work - VibeMap's AI will help refine it

• 5-10 minutes: For the initial project creation and first generation

• Basic project context: Understanding of your target users and main goals

What VibeMap Will Generate

Once you create a project, VibeMap's AI will automatically generate:

• User Personas - Who will use your product

• Features - Core functionality breakdown

• User Stories - Detailed requirements from user perspective

• Acceptance Criteria - Testable conditions for each feature

• Pages & Components - UI structure and navigation

• Database Schema - Data model and relationships

• File Structure - Application architecture recommendations

Step-by-Step Project Creation

Step 1: Access the New Project Page

1. From Dashboard: Click the large "New Project" button on your dashboard

2. Direct Navigation: Go to /project/new in your browser

3. Quick Access: Use the keyboard shortcut Ctrl/Cmd + N

Step 2: Fill Out the Project Form

The new project form has two main fields:

Project Name

• Required: Must be 3-100 characters

• Be Descriptive: Choose a name that clearly identifies your project

• Examples:

  • ✅ "E-commerce Mobile App"

  • ✅ "Task Management SaaS Platform"

  • ❌ "My App" (too vague)

Project Description (The Most Important Part!)

• Minimum: 50 characters (but more is better!)

• Maximum: 20,000 characters

• Be Detailed: The more context you provide, the better the AI generation

Step 3: Choose Your AI Model

VibeMap offers different AI models for generation:

• Claude 3.5 Sonnet (Recommended): Best for complex projects with nuanced requirements

• GPT-4: Excellent for technical projects and detailed specifications

• GPT-3.5 Turbo: Fast and cost-effective for simpler projects

Pro Tip: Start with Claude 3.5 Sonnet for the best results, especially for your first project.

Step 4: Create and Generate

1. Click "Generate Project Plan": This creates your project and starts AI generation

2. Real-time Progress: Watch as VibeMap analyzes your description

3. Live Updates: See content building up in real-time during generation

4. Automatic Redirect: You'll be taken to your project workspace when complete

What Happens During Generation

Phase 1: Analysis (0-30 seconds)

• AI Processing: VibeMap analyzes your project description

• Context Building: Understanding business goals, user needs, and technical requirements

• Planning: Determining the scope and complexity of your project

Phase 2: Generation (30 seconds - 5 minutes)

• Sequential Creation: Personas → Features → User Stories → Acceptance Criteria → Pages → Database → File Structure

• Real-time Streaming: Watch content appear as it's generated

• Progress Tracking: Clear indicators show generation progress

• Quality Validation: AI ensures consistency across all artifacts

Phase 3: Completion (Final 30 seconds)

• Final Processing: Organizing and structuring all generated content

• Relationship Mapping: Connecting related artifacts and ensuring consistency

• Workspace Setup: Preparing your project workspace for immediate use

Understanding Your Project Workspace

Once generation completes, you'll be redirected to your project workspace at /project/[projectId]. Here's what you'll find:

🎯 Project Header

• Project Name & Description: Your original project details

• Generation Status: Visual indicators showing completion status

• Quick Actions: Edit project details, duplicate, or delete

🗂️ Sidebar Navigation

The left sidebar provides access to all generated artifacts:

• 📊 Dashboard: Project overview and progress summary

• 👥 Personas: User profiles and characteristics

• ⚡ Features: Core functionality breakdown

• 📋 User Stories: Detailed requirements from user perspective

• ✅ Acceptance Criteria: Testable conditions for each feature

• 📄 Pages & Components: UI structure and navigation relationships

• 🗄️ Database Schema: Data model with entities and relationships

• 📁 File Structure: Application architecture and file organization

📱 Main Content Area

• Artifact Display: Shows the selected artifact type

• Interactive Editing: Click any item to edit directly

• Real-time Updates: Changes save automatically

• Export Options: Generate documentation in multiple formats

Project Creation Best Practices

Writing Effective Project Descriptions

✅ Good Example:

I want to build a task management SaaS platform for remote teams. 
Users should be able to create projects, assign tasks to team members, 
set deadlines, and track progress. The platform needs real-time 
collaboration features, file sharing, time tracking, and reporting 
dashboards. Team leads need approval workflows, and admins require 
user management and billing features. Integration with Slack and 
Google Calendar is essential. The target audience is small to 
medium businesses with 5-50 employees.

❌ Poor Example:

Build a task app for teams.

Key Elements to Include

1. Target Audience: Who will use your product

2. Core Features: Main functionality you need

3. User Roles: Different types of users (admin, user, etc.)

4. Integration Requirements: Third-party services or APIs

5. Technical Preferences: Platform, technology stack, etc.

6. Business Context: Goals, constraints, and success metrics

Troubleshooting Project Creation

Common Issues & Solutions

"Prompt too short" Error:

• Add more detail about your target users and core features

• Include specific use cases or user scenarios

• Describe the business problem you're solving

Generation Taking Too Long:

• Complex projects may take 5-10 minutes to generate completely

• Check your internet connection

• Large descriptions (10,000+ characters) take longer to process

Incomplete Generation:

• Refresh the page and try again

• Check your subscription limits

• Contact support if the issue persists

Poor Quality Output:

• Provide more specific details in your project description

• Include examples of similar products or features

• Try a different AI model for generation

Next Steps After Project Creation

1. Review Generated Content

• Start with Personas: Ensure they match your target audience

• Check Features: Verify all core functionality is covered

• Review User Stories: Make sure they capture your requirements

2. Customize and Refine

• Edit Content: Click any item to modify it directly

• Add Missing Elements: Use the AI assistant to generate additional content

• Reorganize: Drag and drop to reorder features or stories

3. Export and Share

• Generate Documentation: Create professional project documentation

• Share with Team: Invite team members to review and collaborate

• Export to Tools: Import into your preferred project management software

4. Iterate and Improve

• Gather Feedback: Get input from stakeholders and team members

• Refine Requirements: Update based on feedback and new insights

• Generate Additional Content: Use the AI assistant for expansions

Pro Tips for Success

First Project Recommendations

• Start Simple: Choose a project you understand well

• Be Specific: Include real user scenarios and use cases

• Think End-to-End: Consider the complete user journey

• Include Constraints: Mention any technical or business limitations

Maximizing AI Generation Quality

• Use Examples: Reference similar products or features

• Include Context: Explain the business problem you're solving

• Be Realistic: Set appropriate scope expectations

• Iterate: Don't expect perfect results on the first try

Ready to create your first project? Head to the dashboard and click "New Project" to get started!