Skip to content

Project Creation

Creating a project is the entry point to the AI design pipeline.

User Flow

  1. User clicks New Project
  2. Enters project name + brief (free text description)
  3. Optionally uploads brand assets (logo, colors)
  4. Clicks Generate → AI pipeline runs
  5. Preview is shown, user can iterate

Code Path

src/routes/(app)/projects/new/+page.svelte
  → POST /api/projects          (creates DB record)
  → POST /api/generate          (starts AI pipeline)
  → SSE stream → UI updates     (live progress)
  → redirect /projects/:id      (on completion)

Brief Input Guidelines

The brief input accepts free text but the Planner Agent extracts these signals:

SignalExample
Industry"Steuerberatung", "SaaS", "Handwerk"
Target audience"Unternehmer", "Freelancer", "B2B"
Tone"professionell", "modern", "vertrauensvoll"
Goal"Anfragen generieren", "Demo buchen"
Existing branding"Farbe: #1A6B4A", "Logo attached"

More context = better output. Short briefs produce generic designs.

Status States

StatusMeaning
draftCreated, no generation run yet
generatingAI pipeline running
readyGeneration successful, preview available
errorPipeline failed, partial result stored
publishedExported/deployed

Error Handling

If generation fails mid-pipeline, the project enters error state. The partial result (e.g., design brief without code) is preserved. The user can:

  • Retry generation (resumes from last checkpoint)
  • Edit the brief and re-generate
  • View error details in the project settings

Internal documentation for development team