chore: complete v1 milestone

Archived:
- milestones/v1-ROADMAP.md
- milestones/v1-REQUIREMENTS.md
- milestones/v1-MILESTONE-AUDIT.md

Deleted (fresh for next milestone):
- ROADMAP.md
- REQUIREMENTS.md

Updated:
- MILESTONES.md (new entry)
- PROJECT.md (requirements → Validated, key decisions updated)
- STATE.md (reset for next milestone)

v1 delivered: platform foundations, full-text search, polished visual
design, and comprehensive content audit across 4 phases, 11 plans,
18 requirements satisfied.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: Stephan Wald

.planning/MILESTONES.md

@@ -0,0 +1,26 @@
+# Project Milestones: BBj DWC Training Course Enhancement
+
+## v1 Platform Foundations (Shipped: 2026-01-31)
+
+**Delivered:** Platform foundations, full-text search, polished visual design, and comprehensive content audit transforming the BBj DWC Training Course into a consultant-ready resource
+
+**Phases completed:** 1-4 (11 plans total)
+
+**Key accomplishments:**
+- Resolved config risks (future.v4 removal, baseUrl fix) and hardened CI with TypeScript typecheck gate before build
+- Enabled full-text search, Mermaid diagrams, responsive image optimization (45 PNGs), and code copy buttons
+- Redesigned homepage (Hero + Features + Cards + CTA), restructured sidebar into 4 logical groups, and shifted to professional blue palette with verified dark mode
+- Audited all 12 chapters with 6-dimension rubric, producing tier-ranked improvement priorities and actionable v2 content roadmap
+- Cross-phase integration verified: 15 connections, 4 E2E flows, zero gaps
+
+**Stats:**
+- 234 files created/modified
+- 41,555 lines added (TypeScript, CSS, Markdown, planning docs)
+- 4 phases, 11 plans
+- 10 days from start to ship (2026-01-21 to 2026-01-31)
+
+**Git range:** `feat(01-01)` → `docs(04)`
+
+**What's next:** v2 content depth — address systemic code example gaps (2.7/5.0), expand thin chapters, add Mermaid diagrams to 8 chapters, guided by content audit tier ranking
+
+---

.planning/PROJECT.md

@@ -2,7 +2,7 @@
 
 ## What This Is
 
-A comprehensive enhancement of the BBj Dynamic Web Client (DWC) Training Course website — a 12-chapter Docusaurus site teaching BBj developers DWC development. The course content is proven and field-tested. This project transforms it from a static training site into a community hub: better platform features, deeper content, AI assistance, multi-language support, and a showcase that makes DWC attractive to developers.
+A polished, searchable Docusaurus site for the BBj Dynamic Web Client (DWC) Training Course — a 12-chapter curriculum teaching BBj developers DWC development. The course content is proven and field-tested. v1 delivered platform foundations (search, visual tooling, responsive design, CI hardening) and a comprehensive content audit. The next focus is content depth enhancement, AI assistance, internationalization, and a showcase gallery.
 
 ## Core Value
 
@@ -15,37 +15,47 @@ The site must be the definitive, go-to resource for learning and adopting DWC 
 - ✓ 12-chapter course structure covering GUI-to-DWC migration through deployment — existing
 - ✓ Docusaurus 3.9.2 static site with React 19 and TypeScript — existing
 - ✓ GitHub Pages deployment via GitHub Actions CI/CD — existing
-- ✓ Auto-generated sidebar navigation from docs directory — existing
-- ✓ Custom theme with dark mode support (green color scheme) — existing
-- ✓ Interactive homepage with ChapterCards and HomepageFeatures components — existing
 - ✓ Code syntax highlighting for Java, Bash, and BBj — existing
 - ✓ Sample BBj source code in `samples/` directory — existing
 - ✓ External links to BASIS documentation and DWC docs — existing
+- ✓ Full-text search across all course content (local search) — v1
+- ✓ Search accessible via keyboard shortcut (Cmd+K / Ctrl+K) — v1
+- ✓ Search results show context snippets and link to specific sections — v1
+- ✓ Sidebar chapters grouped into logical sections (Getting Started, Core Concepts, Advanced Topics, Deployment) — v1
+- ✓ Responsive components render correctly on mobile/tablet/desktop — v1
+- ✓ Cross-browser testing (Chrome, Firefox, Safari) — v1
+- ✓ Mermaid diagrams enabled for architecture and flow diagrams — v1
+- ✓ Code block copy button enabled across all code blocks — v1
+- ✓ Image optimization via IdealImage (responsive sizing, blur-up placeholders) — v1
+- ✓ Homepage redesigned (Hero + Features + Cards + CTA) — v1
+- ✓ Consistent visual language with professional blue palette — v1
+- ✓ Dark mode verified working with all components and diagrams — v1
+- ✓ CI pipeline with TypeScript typecheck gate before build — v1
+- ✓ Content audit: all 12 chapters evaluated with tier-ranked improvement priorities — v1
 
 ### Active
 
-**Platform — Search & Discovery:**
-- [ ] Algolia DocSearch integration (reference: docs.webforj.com uses this)
-- [ ] Improved navigation for consultants who need fast access to specific topics
+**Platform — Search Upgrade:**
+- [ ] Algolia DocSearch integration (upgrade from local search; reference: docs.webforj.com)
+- [ ] contextualSearch for i18n locale awareness
 
 **Platform — AI Chat Assistant:**
 - [ ] Context-aware AI chatbot that knows course content and DWC documentation
 - [ ] Answers DWC questions in natural language
 - [ ] Guides learners through material (suggests next steps, explains concepts)
 - [ ] Works within static site constraints (client-side, no backend)
 
-**Platform — Look & Feel:**
-- [ ] Polished, modern visual design worthy of showing to prospects and customers
-- [ ] Improved UX for both self-paced learners and consultants cherry-picking topics
-
 **Platform — DWC Showcase Gallery:**
 - [ ] Gallery of demo apps built with DWC by BASIS
 - [ ] Demonstrates real-world patterns and capabilities to attract developers
 
-**Content — Depth Enhancement:**
-- [ ] More code examples with explanations across all chapters
-- [ ] Architecture diagrams, flow charts, annotated screenshots
-- [ ] Content quality audit: clarity, logical flow, relevance, completeness
+**Content — Depth Enhancement (guided by v1 content audit):**
+- [ ] Add inline code blocks to Ch04 and Ch05 (zero code blocks currently — Critical tier)
+- [ ] Expand Flexbox coverage in Ch06 and add DWC integration examples
+- [ ] Add code annotations and progressive complexity curriculum-wide (9 chapters have gaps)
+- [ ] Add Mermaid diagrams to 8 chapters (18 opportunities identified)
+- [ ] Expand thin chapters (7 of 12 under 150 lines)
+- [ ] Add chapter summaries and navigation links (10 chapters missing)
 
 **Content — Video/Multimedia:**
 - [ ] Synthesia AI avatar videos explaining key concepts
@@ -73,7 +83,8 @@ The site must be the definitive, go-to resource for learning and adopting DWC 
 - **Language community:** Spanish and French-speaking developers adopt more slowly due to language barrier. Making them feel recognized through native-language content is a strategic priority.
 - **Existing reference:** docs.webforj.com uses Algolia with Docusaurus — serves as a model for search integration here.
 - **Synthesia license:** Team has access to Synthesia for AI avatar video production.
-- **Codebase state:** Docusaurus 3.9.2, React 19, TypeScript 5.6, GitHub Pages. No test framework, no linting. See `.planning/codebase/` for detailed analysis.
+- **Codebase state:** Docusaurus 3.9.2, React 19, TypeScript 5.6, GitHub Pages. Blue palette (Tailwind Blue scale). Local search via @easyops-cn/docusaurus-search-local. Mermaid diagrams enabled. IdealImage with 45 PNGs across 9 docs. CI pipeline with typecheck gate. See `.planning/codebase/` for detailed analysis.
+- **Content audit findings:** Completeness (2.7/5.0) and Code Examples Quality (2.7/5.0) are systemic weaknesses. Ch04 and Ch05 have zero inline code blocks. 7 of 12 chapters under 150 lines. See `.planning/phases/04-content-audit/04-SUMMARY.md` for full tier ranking and recommendations.
 
 ## Constraints
 
@@ -87,11 +98,17 @@ The site must be the definitive, go-to resource for learning and adopting DWC 
 
 | Decision | Rationale | Outcome |
 |----------|-----------|---------|
-| Stay on Docusaurus | Committed to framework, team familiar with it | — Pending |
-| Algolia for search | Already proven on docs.webforj.com | — Pending |
+| Stay on Docusaurus | Committed to framework, team familiar with it | ✓ Good |
+| Local search instead of Algolia | Algolia requires approval; local search provides equivalent UX immediately | ✓ Good — upgrade path to Algolia remains open |
+| Removed future.v4 flag | CSS Cascade Layers production bug (Issue #11567) | ✓ Good — clean build, no warnings |
+| React 19 kept (no downgrade) | All plugins confirmed compatible | ✓ Good |
+| Blue palette (Tailwind Blue scale) | Professional, WCAG-AA compliant, consistent with Docusaurus theming | ✓ Good |
+| Text-focused homepage (no illustrations) | Faster to ship, professional look without custom art | ✓ Good |
+| Sidebar 4-group structure | Getting Started / Core Concepts / Advanced Topics / Deployment | ✓ Good |
+| GIF exclusion from IdealImage | Build-time processing breaks GIF animation | ✓ Good |
 | Synthesia for video | License already available, supports multi-language | — Pending |
 | AI-assisted translation | Budget-conscious way to reach French/Spanish community | — Pending |
-| Static-only architecture | GitHub Pages hosting, no backend budget | — Pending |
+| Static-only architecture | GitHub Pages hosting, no backend budget | ✓ Good |
 
 ---
-*Last updated: 2026-01-31 after initialization*
+*Last updated: 2026-01-31 after v1 milestone*