whiteport-design-studio 0.2.2 → 0.3.0

package/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md

@@ -1,203 +0,0 @@
-# Lesson 01: GitHub & IDE Setup
-
-**Get your development environment ready**
-
----
-
-## What You'll Do
-
-- Create GitHub account
-- Create or join repository
-- Install IDE (Cursor or VS Code)
-- Verify everything works
-
-**Time:** 25-30 minutes
-
----
-
-## Part 1: GitHub Setup
-
-### What is GitHub?
-
-Professional cloud storage + time machine for your project files. Every change is saved, you can go back to any version, and you can work with others.
-
-### Step 1: Create GitHub Account
-
-1. Go to **<https://github.com>**
-2. Click **"Sign up"** (top right)
-3. Enter email, password, username
-
-**Username Tips:**
-- Professional: `john-designer`, `sarahux`, `mike-creates`
-- You might share this with clients
-
-4. Verify email
-5. Log in
-
-**✅ Checkpoint:** You can log in to GitHub
-
----
-
-### Step 2: Choose Your Scenario
-
-**Scenario A: Starting a New Project** → Continue to Step 3  
-**Scenario B: Joining Existing Project** → Skip to Step 6  
-**Scenario C: Just Learning WDS** → Skip to Part 2
-
----
-
-### Step 3: Create Repository (Scenario A)
-
-1. Click profile icon → **"Your repositories"** → **"New"**
-
-### Step 4: Decide Repository Structure
-
-**IMPORTANT: Your naming choice determines your structure!**
-
-#### Single Repository
-
-**Name:** `my-project` (e.g., `dog-walker-app`)
-
-```
-my-project/
-├── docs/    ← WDS specifications
-└── src/     ← Code
-```
-
-**Use when:**
-- Small team, building yourself
-- Simple communication
-- Rapid iteration
-
-#### Separate Specifications Repository
-
-**Name:** `my-project-specs` (e.g., `dog-walker-app-specs`)
-
-```
-my-project-specs/    ← Specifications only
-my-project/          ← Separate code repo
-```
-
-**Use when:**
-- Corporate environment
-- Many developers
-- Clear handoff needed
-
-### Step 5: Create Repository
-
-- **Name:** `____________` (lowercase-with-hyphens)
-- **Description:** One-liner about project
-- **Public** (portfolio) or **Private** (client work)
-- ☑️ **Check "Initialize with README"**
-- Click **"Create repository"**
-
-**✅ Checkpoint:** Repository created
-
----
-
-### Step 6: Join Existing Repository (Scenario B)
-
-**Email template:**
-
-```
-Hi [Name],
-
-I'd like to contribute to [project-name] using WDS methodology. 
-Could you add me as a collaborator?
-
-My GitHub username: [your-username]
-
-Thank you!
-```
-
-**Then:**
-1. Accept invitation from email
-2. Check repo name (ends in `-specs`? Separate repo)
-3. Browse structure (has `docs/`? WDS already!)
-
-**✅ Checkpoint:** Access granted
-
----
-
-## Part 2: IDE Installation
-
-### What is an IDE?
-
-Your workspace for creating specifications. Like Microsoft Word, but for design files.
-
-### Step 1: Choose Your IDE
-
-**Cursor (Recommended)**
-- Built for AI assistance
-- Perfect for WDS
-- Download: <https://cursor.sh>
-
-**VS Code (Alternative)**
-- Industry standard
-- Works great too
-- Download: <https://code.visualstudio.com>
-
-**For beginners:** Choose Cursor
-
----
-
-### Step 2: Install
-
-**Windows:**
-1. Run `.exe` file
-2. Click through installer
-3. Use defaults
-
-**Mac:**
-1. Open download
-2. Drag to Applications
-3. Open from Applications
-
-**Linux:**
-Follow distro instructions
-
----
-
-### Step 3: First Launch
-
-1. Choose theme (Light/Dark)
-2. **Sign in with GitHub** → Yes!
-3. Install recommended extensions → Yes
-
-**✅ Checkpoint:** IDE open and ready
-
----
-
-### Step 4: Verify Terminal
-
-Press **Ctrl+`** (Win/Linux) or **Cmd+`** (Mac)
-
-**✅ Checkpoint:** Terminal panel appears
-
----
-
-## Troubleshooting
-
-**GitHub Issues:**
-- **Verification email missing** → Check spam
-- **Username taken** → Try `yourname-designer-2`
-- **Repository name taken** → Add your username
-
-**IDE Issues:**
-- **Can't find download** → Check Downloads folder
-- **Mac "unidentified developer"** → Right-click → Open
-- **Terminal won't open** → View menu → Terminal → New Terminal
-
----
-
-## What's Next?
-
-GitHub account, repository, and IDE are ready! Now let's configure Git.
-
-**[Continue to Lesson 02: Git Configuration →](../lesson-02-git-setup/lesson.md)**
-
----
-
-*Part of Module 02: Installation & Setup*  
-*[← Back to Module Overview](../module-02-overview.md)*
-

package/docs/learn-wds/module-02-installation-setup/lesson-01-setting-up-github/checklist.md

@@ -1,70 +0,0 @@
-# Lesson 01: GitHub Setup - Quick Checklist
-
-**⏱️ 15-20 minutes**
-
----
-
-## Create GitHub Account
-
-- [ ] Go to **<https://github.com>**
-- [ ] Click **"Sign up"**
-- [ ] Enter email, password, username (professional: `yourname-designer`)
-- [ ] Verify email
-- [ ] ✅ Log in successful
-
----
-
-## Choose Your Scenario
-
-- [ ] **A:** Starting new project → Continue below
-- [ ] **B:** Joining existing → Skip to "Join Existing" section
-- [ ] **C:** Just learning → Skip to [Lesson 02](../lesson-02-install-ide/checklist.md)
-
----
-
-## Create New Repository
-
-- [ ] Click profile icon → **"Your repositories"** → **"New"**
-
-### Decide: Single or Separate?
-
-**Single repo (specs + code together):**
-- [ ] Name: `my-project` (e.g., `dog-walker-app`)
-- [ ] For: Small team, building yourself, simple communication
-
-**Separate specs repo (specs only):**
-- [ ] Name: `my-project-specs` (e.g., `dog-walker-app-specs`)
-- [ ] For: Corporate, many developers, clear handoff
-
-### Repository Settings
-
-- [ ] Name: `_____________` (lowercase-with-hyphens)
-- [ ] Description: One-liner about project
-- [ ] Public or Private
-- [ ] ☑️ **Check "Initialize with README"**
-- [ ] Click **"Create repository"**
-- [ ] ✅ Repository created
-
----
-
-## Join Existing Repository
-
-- [ ] Ask owner for access (email template in lesson.md)
-- [ ] Check email for GitHub invitation
-- [ ] Click **"Accept invitation"**
-- [ ] Check repo name (ends in `-specs`? Separate repo)
-- [ ] Browse repo structure (has `docs/`? WDS already!)
-- [ ] ✅ Access granted
-
----
-
-## Next Step
-
-✅ GitHub setup complete!
-
-**[→ Lesson 02: IDE Installation](../lesson-02-install-ide/checklist.md)**
-
----
-
-**Need more detail?** See [full lesson explanation](lesson.md)
-

package/docs/learn-wds/module-02-installation-setup/lesson-02-git-configuration/checklist.md

@@ -1,40 +0,0 @@
-# Lesson 02: Git Configuration - Quick Checklist
-
-**⏱️ 5 minutes**
-
----
-
-## Choose Approach
-
-- [ ] **Option 1:** Let Cursor handle Git (do nothing - easiest!)
-- [ ] **Option 2:** Use GitHub Desktop (visual) → <https://desktop.github.com>
-
----
-
-## If Using GitHub Desktop
-
-- [ ] Download from <https://desktop.github.com>
-- [ ] Install
-- [ ] Sign in with GitHub account
-- [ ] ✅ Ready for visual cloning
-
----
-
-## Recap Repository Structure
-
-From Lesson 01:
-- [ ] Single repo: `my-project` (specs + code together)
-- [ ] Separate repo: `my-project-specs` (specs only)
-
----
-
-## Next Step
-
-✅ Git ready!
-
-**[→ Lesson 03: Repository Cloning & WDS Integration](../lesson-03-clone-and-wds/checklist.md)**
-
----
-
-**Need more detail?** See [full lesson explanation](lesson.md)
-

package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/01-quick-checklist.md

@@ -1,48 +0,0 @@
-# Lesson 02: IDE Installation - Quick Checklist
-
-**⏱️ 10 minutes**
-
----
-
-## Choose IDE
-
-- [ ] **Cursor** (recommended) → <https://cursor.sh>
-- [ ] **VS Code** (alternative) → <https://code.visualstudio.com>
-
----
-
-## Install
-
-- [ ] Download installer
-- [ ] **Windows:** Run `.exe`, click through
-- [ ] **Mac:** Drag to Applications, open
-- [ ] **Linux:** Follow distro instructions
-
----
-
-## First Launch
-
-- [ ] Choose theme (Light/Dark)
-- [ ] Sign in with GitHub → Yes!
-- [ ] Install recommended extensions → Yes
-- [ ] ✅ IDE open
-
----
-
-## Verify Terminal
-
-- [ ] Press **Ctrl+`** (Win/Linux) or **Cmd+`** (Mac)
-- [ ] ✅ Terminal panel appears
-
----
-
-## Next Step
-
-✅ IDE installed!
-
-**[→ Lesson 03: Git Repository Cloning](../lesson-03-git-cloning/01-quick-checklist.md)**
-
----
-
-**Need more detail?** See [full lesson](02-full-lesson.md)
-

package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-full-lesson.md

@@ -1,88 +0,0 @@
-# Lesson 02: IDE Installation
-
-**Get your workspace ready**
-
----
-
-## What You'll Do
-
-- Choose IDE (Cursor or VS Code)
-- Install and configure
-- Verify terminal works
-
-**Time:** 10 minutes
-
----
-
-## Step 1: Choose Your IDE
-
-### Cursor (Recommended)
-
-- Built for AI assistance
-- Perfect for WDS
-- Download: <https://cursor.sh>
-
-### VS Code (Alternative)
-
-- Industry standard
-- Works great too
-- Download: <https://code.visualstudio.com>
-
-**For beginners:** Choose Cursor
-
----
-
-## Step 2: Install
-
-**Windows:**
-1. Run `.exe` file
-2. Click through installer
-3. Use defaults
-
-**Mac:**
-1. Open download
-2. Drag to Applications
-3. Open from Applications
-
-**Linux:**
-Follow distro instructions
-
----
-
-## Step 3: First Launch
-
-1. Choose theme (Light/Dark)
-2. **Sign in with GitHub** → Yes!
-3. Install recommended extensions → Yes
-
-**✅ Checkpoint:** IDE open
-
----
-
-## Step 4: Verify Terminal
-
-Press **Ctrl+`** (Win/Linux) or **Cmd+`** (Mac)
-
-**✅ Checkpoint:** Terminal panel appears
-
----
-
-## Troubleshooting
-
-**Issue:** Can't find download → Check Downloads folder  
-**Issue:** Mac "unidentified developer" → Right-click → Open  
-**Issue:** Terminal won't open → View menu → Terminal → New Terminal
-
----
-
-## What's Next?
-
-IDE ready! Now clone your Git repository.
-
-**[Continue to Lesson 03: Git Repository Cloning →](../lesson-03-git-cloning/02-full-lesson.md)**
-
----
-
-*Part of Module 02: Installation & Setup*  
-*[← Back to Module Overview](../module-02-overview.md)*
-

package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-quick-checklist.md

@@ -1,48 +0,0 @@
-# Lesson 02: IDE Installation - Quick Checklist
-
-**⏱️ 10 minutes**
-
----
-
-## Choose IDE
-
-- [ ] **Cursor** (recommended) → <https://cursor.sh>
-- [ ] **VS Code** (alternative) → <https://code.visualstudio.com>
-
----
-
-## Install
-
-- [ ] Download installer
-- [ ] **Windows:** Run `.exe`, click through
-- [ ] **Mac:** Drag to Applications, open
-- [ ] **Linux:** Follow distro instructions
-
----
-
-## First Launch
-
-- [ ] Choose theme (Light/Dark)
-- [ ] Sign in with GitHub → Yes!
-- [ ] Install recommended extensions → Yes
-- [ ] ✅ IDE open
-
----
-
-## Verify Terminal
-
-- [ ] Press **Ctrl+`** (Win/Linux) or **Cmd+`** (Mac)
-- [ ] ✅ Terminal panel appears
-
----
-
-## Next Step
-
-✅ IDE installed!
-
-**[→ Lesson 03: Git Repository Cloning](../lesson-03-git-cloning/01-quick-checklist.md)**
-
----
-
-**Need more detail?** See [full lesson](02-full-lesson.md)
-

package/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/checklist.md

@@ -1,48 +0,0 @@
-# Lesson 02: IDE Installation - Quick Checklist
-
-**⏱️ 10 minutes**
-
----
-
-## Choose IDE
-
-- [ ] **Cursor** (recommended for AI work) → <https://cursor.sh>
-- [ ] **VS Code** (alternative) → <https://code.visualstudio.com>
-
----
-
-## Install
-
-- [ ] Download installer
-- [ ] **Windows:** Run `.exe`, click through
-- [ ] **Mac:** Drag to Applications, open
-- [ ] **Linux:** Follow distro instructions
-
----
-
-## First Launch
-
-- [ ] Choose theme (Light/Dark)
-- [ ] **Sign in with GitHub** → Yes!
-- [ ] Install recommended extensions → Yes
-- [ ] ✅ IDE open
-
----
-
-## Verify Terminal
-
-- [ ] Press **Ctrl+`** (Win/Linux) or **Cmd+`** (Mac)
-- [ ] ✅ Terminal panel appears
-
----
-
-## Next Step
-
-✅ IDE installed!
-
-**[→ Lesson 03: Git Configuration](../lesson-03-git-setup/checklist.md)**
-
----
-
-**Need more detail?** See [full lesson explanation](lesson.md)
-

package/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/tutorial.md

@@ -1,149 +0,0 @@
-# Lesson 02: IDE Installation
-
-**Get your workspace set up with Cursor or VS Code**
-
----
-
-## What You'll Do
-
-- Choose between Cursor and VS Code
-- Download and install your IDE
-- Complete first-launch setup
-- Sign in with GitHub
-
-**Time:** 10 minutes
-
----
-
-## What is an IDE?
-
-**IDE = Integrated Development Environment**
-
-Your workspace for creating specifications. Like Microsoft Word, but for design files.
-
----
-
-## Step 1: Choose Your IDE
-
-### Cursor (Recommended)
-
-**Why Cursor:**
-- Built for AI assistance
-- Modern interface
-- Perfect for WDS
-- **Download:** <https://cursor.sh>
-
-### VS Code (Alternative)
-
-**Why VS Code:**
-- Industry standard
-- More extensions
-- Works great with WDS too
-- **Download:** <https://code.visualstudio.com>
-
-**For beginners:** Choose Cursor. It's designed for AI-augmented work.
-
----
-
-## Step 2: Install Cursor
-
-### 2.1 Download
-
-1. Go to **<https://cursor.sh>**
-2. Click download button for your platform
-3. Wait for download
-
-### 2.2 Install
-
-**Windows:**
-1. Double-click the `.exe` file
-2. Follow installer prompts
-3. Use default settings
-4. Click "Finish"
-
-**Mac:**
-1. Open the download
-2. Drag Cursor to Applications folder
-3. Open Applications folder
-4. Double-click Cursor to launch
-
-**Linux:**
-1. Follow installation instructions for your distribution
-
----
-
-## Step 3: First Launch Setup
-
-1. Open Cursor for the first time
-2. Choose your theme (Light or Dark - you can change this later)
-
-### 3.1 Setup Wizard
-
-Cursor will ask you a few questions:
-
-- **"Import settings from VS Code?"** → Skip (unless you already use VS Code)
-- **"Sign in with GitHub?"** → Yes! (makes cloning easier)
-- **"Install recommended extensions?"** → Yes
-
-**✅ Checkpoint:** Cursor is open and ready
-
----
-
-## Install VS Code (Alternative)
-
-If you chose VS Code instead:
-
-### Download and Install
-
-1. Go to **<https://code.visualstudio.com>**
-2. Download for your platform
-3. Follow same installation steps as Cursor above
-4. Complete first-launch setup
-5. Sign in with GitHub when prompted
-
----
-
-## Verify Installation
-
-### Open the Terminal
-
-This is important for upcoming lessons!
-
-**Windows / Linux:**
-- Press **Ctrl + `** (backtick key, usually above Tab)
-
-**Mac:**
-- Press **Cmd + `** (backtick key)
-
-**You should see a terminal panel appear at the bottom!**
-
-**✅ Checkpoint:** Terminal opens successfully
-
----
-
-## Troubleshooting
-
-**Issue:** Can't find download  
-**Solution:** Check your Downloads folder
-
-**Issue:** Mac says "Cannot open - unidentified developer"  
-**Solution:** Right-click Cursor → Click "Open" → Click "Open" again
-
-**Issue:** Terminal won't open  
-**Solution:** View menu → Terminal → New Terminal
-
-**Issue:** GitHub sign-in fails  
-**Solution:** You can skip for now, we'll handle it later
-
----
-
-## What's Next?
-
-Your IDE is ready! Now let's understand Git and how your IDE handles it automatically.
-
-**[Continue to Lesson 03: Git Configuration →](../lesson-03-git-setup/tutorial.md)**
-
----
-
-*Part of Module 02: Installation & Setup*  
-*[← Back to Module Overview](../module-02-overview.md)*