# AI Website Creation Studio (/start)

> The official prompt-to-website generation studio for NoCodeVista. Describe any business, portfolio, or landing page idea to synthesize complete, high-converting, responsive websites in seconds without code.

## 1. Screen Purpose & Capabilities

The /start screen is the primary creation engine of NoCodeVista. It provides a zero-friction, prompt-driven workspace where solopreneurs, creators, and agencies can generate fully functional, responsive websites from natural language prompts.

Key capabilities:
- Zero upfront sign-up barrier: users can generate websites as anonymous guests without a credit card.
- Prompt Genome Analysis: automatically extracts domain entities, industry niche, color harmonies, and layout requirements.
- Full-page synthesis: produces complete, multi-section pages including Navigation, Hero, Features, Testimonials, Comparison Tables, FAQs, and Contact Forms.
- Immediate handoff: automatically opens the generated website inside the interactive visual canvas editor (/page-builder).

## 2. Input Specifications & Controls

- Prompt Textarea: multi-line input supporting detailed website prompts.
- Keyboard Shortcuts:
  - Enter: triggers instant website generation.
  - Shift+Enter: inserts a new line for detailed multi-paragraph prompts.
- Rotating Suggestions: dynamic placeholders cycling through industry use cases to spark inspiration.
- Character Limit: supports prompts from short 5-word concepts to comprehensive 2,000-character project specifications.

## 3. URL Parameters & Funnel Handoff

The /start screen supports automatic hydration from external marketing campaigns and landing page widgets:

- ?prompt=<text>: automatically populates the prompt textarea upon page load.
- ?auto=true or ?generate=true: automatically triggers the synthesis engine immediately on mount without requiring an extra click.
- ?niche=<niche>: passes specific industry context (e.g. real-estate, dentist, saas, cafe) to tune the generation engine.
- ?source=<source_page>: records attribution telemetry for conversion analytics.

## 4. Quick Starter Chips & Idea Catalog

Users can click ready-made starter chips to test realistic website prompts instantly:

- SaaS Landing Page: "A high-converting landing page for a team productivity software with key features, social proof, pricing tiers, and a free trial call to action."
- Luxury Real Estate: "A luxury property showcase website featuring modern architectural villas, photo galleries, amenity lists, floor plans, and a private tour booking form."
- Artisanal Cafe & Bakery: "A warm, welcoming website for a boutique bakery and specialty cafe with daily specials, menu showcase, customer reviews, hours, and table reservations."
- Designer Portfolio: "A clean, minimalist portfolio for a brand designer featuring case studies, client logos, design philosophy, and a project inquiry form."
- Dental & Medical Clinic: "A trustworthy website for a modern dental clinic with treatment services, dentist bios, patient testimonials, insurance information, and online appointment booking."

An expandable Prompt Ideas Popover provides 40+ curated prompt templates across Business, Creative, Tech, Services, and Personal categories.

## 5. Synthesis Pipeline & Engine Architecture

When generation begins, the Generation Synthesis Engine executes in 4 stages:

1. Entity & Intent Extraction: identifies business type, target audience, core value proposition, and required forms.
2. Structural Layout Blueprint: selects optimal matrix components (Hero, Feature Grids, Social Proof, Pricing, Footer).
3. Aesthetic Color Shader: calculates accessible, WCAG-compliant color palettes and typographic pairings based on industry vibe.
4. Canvas Compilation: compiles AST node graph and transfers session state to the visual Page Builder (/page-builder).

## 6. Guest Mode & Account Claim Protocol

- Anonymous guest sessions are initialized with a guestToken stored in browser localStorage.
- Websites created in guest mode are fully editable and persist across page refreshes.
- When a guest user decides to publish, connect a domain, or log in, their temporary guestToken is automatically merged into their permanent user account.
