Premium Saas Design

What: Single document explaining what you're building, why, and for whom. Purpose: Gives AI direction and understanding of the project.

# Project Brief: [Product Name]

## What We're Building
[Description of the product/website]

## Primary Target Audience
- [Persona 1]: [Description]
- [Persona 2]: [Description]

## Goals
1. [Primary goal - e.g., drive signups]
2. [Secondary goal - e.g., build trust]
3. [Tertiary goal - e.g., explain the product]

## Requirements
- Fully responsive (mobile-first)
- Blazing fast performance
- Accessible (WCAG 2.1 AA)
- [Other requirements]

## Sections
1. Hero
2. Trust Logos
3. Features
4. [etc.]

Key Insight: Think of AI as a new team member. You wouldn't tell them "build me a website" without context.

2. Content Files (One Per Section)

What: Separate file for each section containing all copy/content. Purpose: Focuses AI on content separately from design.

# Hero Section Content

## Headline
[Main headline text]

## Subheadline
[Supporting text]

## CTA Primary
Text: [Button text]
Action: [What happens on click]

## CTA Secondary
Text: [Link text]
Action: [What happens on click]

## Social Proof (optional)
[Trust indicators, stats, etc.]

3. General Vibe Mood Board

What: Visual inspiration for the overall site aesthetic. Purpose: Answers "What should the whole site FEEL like when we land on it?"

# General Vibe

## Overall Aesthetic
- Theme: [Dark/Light/Mixed]
- Feel: [Modern, Professional, Playful, etc.]
- Color Direction: [Primary color family and why]

## Inspiration References

### Reference 1: [Site Name]
- URL: [link]
- What I Like:
  - [Specific element 1]
  - [Specific element 2]
- Screenshot: [embedded image]

### Reference 2: [Site Name]
- URL: [link]
- What I Like:
  - [Specific element 1]
  - [Specific element 2]
- Screenshot: [embedded image]

## Color Psychology
- Primary Color: [Color] - [Why this color for this audience]
  Example: Turquoise/blue evokes professionalism and trust (important for security products)

## Typography Direction
- Headlines: [Font family, weight, style]
- Body: [Font family, size range]

Research Sources:

• Dribbble (search "[industry] SaaS landing page")
• Awwwards
• SaaS Landing Page examples
• Competitor sites

4. Section-Specific Mood Boards

What: Detailed specs for each section - the "Frankenstein" approach. Purpose: Gives AI precise visual direction for every section.

# Hero Section Specs

## Layout Reference
- URL: [Reference site]
- Screenshot: [embedded]
- What to Copy:
  - Text alignment: [left/center/right]
  - Font hierarchy
  - Button placement

## Navigation Bar
### Components
- Logo: [Position, size]
- Menu Links: [Style, hover effects]
- CTA Button: [Shape, color, glow effects]

### Code Reference (from component library)
```tsx
// Include actual component code from shadcn/21st.dev

Hero Content Area

Layout

• [Left/Right/Center aligned]
• [Split layout description]

3D Element (if applicable)

• Source: [Three.js / Sketchfab link]
• Position: [Where in layout]
• Animation: [Type of movement]
• Code:

// Include Three.js or animation code

Components from Libraries

Primary Button

• Source: 21st.dev
• Style: [pill shaped, glow outline, etc.]
• Code:

// Component code

Background Effects

• Type: [Gradient, particles, grid, etc.]
• Source: [Library link]
• Code:

// Effect code

Animations

• Scroll Effects: [Parallax, fade-in, etc.]
• Hover States: [What elements animate]
• Entrance Animations: [Staggered, sequential, etc.]

**Critical**: Be VERY granular. This is where premium separates from generic.

---

### 5. Style Guide (Living Document)
**What**: Single source of truth for all design specs.
**Purpose**: Ensures consistency across the entire project.

```markdown
# Style Guide

## Design Philosophy
[Brief statement about the visual approach]

## Target Audience
[Who this design serves]

## Color Palette

### Primary
- Main: #[hex] - [Usage: CTAs, key highlights]
- Light: #[hex] - [Usage: hover states]
- Dark: #[hex] - [Usage: pressed states]

### Neutral
- Background: #[hex]
- Surface: #[hex]
- Border: #[hex]
- Text Primary: #[hex]
- Text Secondary: #[hex]

### Accent
- Success: #[hex]
- Warning: #[hex]
- Error: #[hex]

### Do's and Don'ts
DO: [Guidance]
DON'T: [Anti-patterns]

## Typography

### Font Families
- Headlines: [Font name], [fallbacks]
- Body: [Font name], [fallbacks]
- Monospace: [Font name] (for code)

### Scale
- Display: [size]px / [line-height]
- H1: [size]px / [line-height]
- H2: [size]px / [line-height]
- H3: [size]px / [line-height]
- Body: [size]px / [line-height]
- Small: [size]px / [line-height]

## Spacing System
- xs: [value]
- sm: [value]
- md: [value]
- lg: [value]
- xl: [value]
- 2xl: [value]

## Border Radius
- sm: [value]
- md: [value]
- lg: [value]
- full: 9999px

## Shadows
[Shadow definitions]

## Animation
- Duration: [fast/medium/slow values]
- Easing: [easing functions]
- Motion Preferences: Respect prefers-reduced-motion

## Component Patterns
[Common patterns used across the site]

Important: This is a LIVING document. AI should update it as learnings emerge.

6. Project Requirements Document (PRD)

What: Technical specification for the entire project. Purpose: Tells AI exactly what tech to use and how.

# Project Requirements Document

## Project Overview
[Brief description]

## Tech Stack
- Framework: [Next.js / Remix / etc.]
- Styling: [Tailwind CSS / CSS Modules / etc.]
- UI Components: [shadcn/ui, Radix, etc.]
- Animation: [Framer Motion / GSAP / etc.]
- 3D: [Three.js / React Three Fiber]
- Icons: [Lucide / Heroicons / etc.]

## Dependencies
```json
{
  "dependencies": {
    // List all required packages
  }
}

File Structure

src/
├── app/
│   └── page.tsx
├── components/
│   ├── ui/           # shadcn components
│   ├── sections/     # Page sections
│   └── 3d/           # Three.js components
├── lib/
│   └── utils.ts
└── styles/
    └── globals.css

Design System

• See: style-guide.md

Page Sections

Responsiveness

• Mobile: 320px - 767px
• Tablet: 768px - 1023px
• Desktop: 1024px+

Performance Requirements

• LCP: < 2.5s
• FID: < 100ms
• CLS: < 0.1

Accessibility

• WCAG 2.1 AA compliance
• Keyboard navigation
• Screen reader support

---

### 7. Tasks Document
**What**: Step-by-step implementation plan.
**Purpose**: Gives AI a clear execution path.

```markdown
# Implementation Tasks

## Phase 1: Project Setup
- [ ] Initialize Next.js project
- [ ] Install dependencies
- [ ] Configure Tailwind CSS
- [ ] Set up shadcn/ui
- [ ] Create folder structure
- [ ] Configure fonts
- [ ] Set up color variables

## Phase 2: Core Components
- [ ] Build navigation bar
- [ ] Create button variants
- [ ] Set up typography components
- [ ] Create layout components

## Phase 3: Section Building
- [ ] Build Hero section
- [ ] Build Trust Logos section
- [ ] Build Features section
- [ ] [Continue for each section]

## Phase 4: Polish
- [ ] Add animations
- [ ] Optimize images
- [ ] Add loading states
- [ ] Mobile responsiveness pass
- [ ] Accessibility audit

## Phase 5: Launch
- [ ] Performance optimization
- [ ] SEO metadata
- [ ] Final review

Component Resources

shadcn/ui

The foundational component library. Copy-paste components with full customization.

• Website: https://ui.shadcn.com
• Usage: Base components (buttons, inputs, cards, etc.)

21st.dev

Premium components built on top of shadcn/ui.

• Website: https://21st.dev
• Usage: Advanced components with animations
• Key Feature: Each component includes:
  • Preview
  • Code to copy
  • AI prompt for installation

Three.js / React Three Fiber

3D graphics in the browser.

• Three.js Examples: https://threejs.org/examples/
• Usage: Hero 3D elements, interactive backgrounds

Sketchfab

Community 3D models and animations.

• Website: https://sketchfab.com
• Usage: Download 3D assets for your hero sections

Best Practices

1. Section Isolation

Start a new chat for each section change:

• Cleaner context (no pollution from other sections)
• Cheaper (fewer tokens consumed)
• More focused results

2. Commit Per Section

After each section is complete:

git add .
git commit -m "feat(landing): add [section-name] section"

This allows easy rollback if iterations go wrong.

3. Include Reference Images

Always paste screenshots in your prompts:

• AI can see exactly what you want
• Reduces ambiguity
• Faster convergence on the right design

4. Include Component Code

When specifying a component from 21st.dev or shadcn:

• Copy the actual code
• Include it in your section spec
• AI can implement it exactly

5. Auto-Update Style Guide

Create a rule file:

# .cursorrules or similar

When building a section and making design decisions that differ from
the style guide, automatically update the style guide to reflect the
new learnings.

6. Screenshot-to-Iteration

When requesting changes:

1. Take a screenshot of the current state
2. Paste it in the prompt
3. Describe what to change
4. Reference the original inspiration if needed

The $500 vs $5000 Difference

Prompt Templates

Generate Style Guide

Based on my mood board and design preferences in [website-sections folder]
and in the [product-brief.md], create a style guide that includes:
- Color palette (with usage guidance)
- Typography scale
- Component styles
- Spacing system
- Animation guidelines

This will be our single source of truth for the entire project.
Do not duplicate content from the section specs.

Generate PRD

Based on my [product-brief.md], [style-guide.md], and all section specs
in [website-sections], create a Project Requirements Document that includes:
- Project overview
- Tech stack (extract from component code in specs)
- Dependencies (extract from component libraries used)
- Design system reference
- Page sections with file references
- File structure
- Responsiveness requirements
- Performance requirements

Generate Tasks

Based on the [style-guide.md] and [prd.md], create a tasks markdown file with:
- Phase 1: Project setup tasks
- Phase 2: Core component tasks
- Phase 3: Section building tasks (one per section)
- Phase 4: Polish tasks
- Phase 5: Launch tasks

Each task should be a checkbox item.
Reference the specific spec files for each section.

Build a Section

Build the [Section Name] section.

Reference files:
- Style guide: @style-guide.md
- Section spec: @[section-name]-section.md
- PRD: @prd.md

Follow the design specs exactly.
Use the components specified.
Match the reference images.

Iterate on a Section

[Paste screenshot of current state]

Changes needed:
1. [Specific change 1]
2. [Specific change 2]

Reference the original inspiration: [paste reference image]

Attribution

This framework is derived from the video "How I Build Premium $5k SaaS Websites with AI" by BuilderSpace (December 2025), which documents a 10-year professional design workflow adapted for AI-assisted development.

Source: https://www.youtube.com/watch?v=WqSf0noa4hk

"The prep work feels like work. You just want to start building. But that upfront context - the brief, the mood boards, the style guide, the section specs - that's what separates a $500 generic website from a $5,000 premium polished one."