Commit Graph

237 Commits

Author SHA1 Message Date
bb067e9999 add missing changelog and update package lock file 2026-01-27 16:47:26 +01:00
1db179929a auto-claude: Merge auto-claude/001-conceptual-explanations 2026-01-12 20:30:53 +01:00
6c65381fcb feat: add Guided Learning Paths feature
Implement PathManager to orchestrate multi-module learning journeys:
- Add PathManager class with start/pause/resume functionality
- Create learning-paths.json config with CSS Fundamentals path
- Integrate path progress tracking with LessonEngine
- Add path selection UI to homepage and navigation
- Include JSON schema for learning path validation
- Add comprehensive test suite for PathManager
2026-01-12 20:30:09 +01:00
d86a8ffa0e docs: add auto-claude spec and tracking files
- Add spec.md and requirements.json for task definition
- Add qa_report.md with QA findings
- Add task_logs.json and task_metadata.json for tracking
2026-01-11 23:35:47 +01:00
30c7459984 auto-claude: Merge auto-claude/001-conceptual-explanations 2026-01-11 23:34:19 +01:00
a4d61fe170 docs: update progress tracking for subtasks 6.2 and 6.3
- Mark subtask 6.2 (mobile responsiveness) as completed
- Mark subtask 6.3 (review and refine explanations) as completed
- Add QA iteration history tracking
2026-01-11 23:33:07 +01:00
212d59462f chore: update .gitignore to ignore user-specific and worktree files 2026-01-11 16:39:54 +01:00
a82fab5312 auto-claude: 6.3 - Final review of all concept texts for clarity, con
- Reviewed all 85+ lesson concepts across 20+ modules
- Trimmed 7 lessons that exceeded 2-4 sentence limit
- Edited 06-transitions-animations.json (all 4 lessons)
- Edited 08-responsive.json (all 4 lessons)
- Preserved beginner-friendly language and WHY focus
- Maintained excellent ASCII diagrams

All concepts now comply with 2-4 sentence guideline while
maintaining clarity and conceptual depth.
2026-01-11 15:17:22 +01:00
4a8f45f878 auto-claude: 6.2 - Test concept section on mobile viewports, ensure diagrams scale appropriately
- Added mobile-specific CSS optimizations for concept section
- Tablet (768px): Reduced diagram font to 0.75rem, padding to 0.75rem
- Mobile (480px): Further reduced to 0.7rem font, 0.5rem padding
- Added momentum scrolling for iOS (-webkit-overflow-scrolling: touch)
- Created comprehensive mobile viewport test report
- Tested across iPhone SE (320px), iPhone 12 (390px), iPad (768px)
- Maintained readability, accessibility, and RTL support
2026-01-11 15:11:04 +01:00
e66dd8b2ad auto-claude: 6.1 - Add tests to verify concept section renders correc 2026-01-11 15:06:58 +01:00
3e431a3850 docs: update build-progress for subtask 5.4 completion 2026-01-11 15:04:42 +01:00
dfd9062a92 feat: add conceptual explanations to Tailwind basics lessons
- Added 'concept' objects to all 5 Tailwind lessons explaining utility-first approach
- Lesson 1 (Backgrounds): Explains pre-built utilities vs custom CSS, color scale system
- Lesson 2 (Utility-First): Explains utility-first philosophy and problems it solves
- Lesson 3 (Text Utilities): Explains naming patterns and color shade system
- Lesson 4 (Spacing): Explains base-4 spacing scale and directional shorthands
- Lesson 5 (Breakpoints): Explains mobile-first responsive utilities and media queries
- All concepts include beginner-friendly explanations and detailed ASCII diagrams
- Emphasizes how Tailwind differs from traditional CSS (no naming, no context-switching, no specificity wars)
- Diagrams show workflow comparisons, naming patterns, spacing scales, and breakpoint cascades
2026-01-11 15:03:38 +01:00
386109733b auto-claude: 5.3 - Add explanations to details/summary, progress/mete 2026-01-11 14:55:43 +01:00
85f2aa47fe auto-claude: 5.2 - Explain native form validation, input types, and accessibility patterns 2026-01-11 14:33:12 +01:00
6e712f6feb auto-claude: 5.1 - Explain semantic HTML and why using proper element 2026-01-11 14:25:14 +01:00
79b858e4f4 auto-claude: 4.6 - Explain media queries, breakpoints, and mobile-first design principles 2026-01-11 14:16:59 +01:00
f388d5b9f9 docs: Update build-progress.txt for subtask 4.5 2026-01-11 14:09:03 +01:00
a7f076135d auto-claude: 4.5 - Explain different layout systems and when to use each approach 2026-01-11 14:07:02 +01:00
5dac8a885b auto-claude: Update build-progress.txt for subtask 4.4 2026-01-11 13:56:29 +01:00
443ec4c198 auto-claude: 4.4 - Explain how CSS transitions interpolate values and keyframe animation timing 2026-01-11 13:49:29 +01:00
9dc06012f1 auto-claude: 4.3 - Explain relative vs absolute units, why rem is pre
Add conceptual explanations to all 4 lessons in 05-units-variables.json:
- Lesson 1 (Absolute vs Relative Units): Explains fixed px vs scalable rem/%, why rem is preferred for accessibility, and how units calculate
- Lesson 2 (CSS Custom Properties): Explains variable definition/reference, inheritance cascade, scoping, and live updates vs preprocessor variables
- Lesson 3 (calc): Explains runtime calculation, mixing units, syntax requirements for operators
- Lesson 4 (Viewport Units): Explains vw/vh/vmin/vmax relative to viewport, auto-resize behavior, and difference from percentage units

All concepts include beginner-friendly explanations (2-4 sentences) and detailed ASCII diagrams showing calculations and visual representations.
2026-01-11 05:35:12 +01:00
180d893bc7 auto-claude: 4.2 - Explain font stacks, web-safe fonts, and how browsers render text 2026-01-11 05:30:03 +01:00
efbd9f18eb auto-claude: 4.1 - Explain color theory basics, color formats (hex, rgb, hsl), and why different formats exist 2026-01-11 05:25:01 +01:00
d475e22afb docs: Update plan and progress for subtask 3.5 completion 2026-01-11 05:20:27 +01:00
3df98fe09a feat: Add conceptual explanations to advanced selectors
Add 'concept' objects to all 4 lessons in 02-selectors.json:
- Element selectors: Explain DOM traversal and specificity (0,0,0,1)
- Class selectors: Explain attribute matching and medium specificity (0,0,1,0)
- ID selectors: Explain uniqueness and high specificity (0,1,0,0)
- Combined selectors: Explain AND logic and specificity addition

Each concept includes:
- Beginner-friendly explanation (2-4 sentences)
- ASCII diagram showing how selectors match
- Specificity comparison and cascade behavior

Subtask 3.5 - Advanced selectors conceptual explanations
2026-01-11 05:18:49 +01:00
435381b03e feat: add box model concept explanations with diagrams
- Added 'concept' objects to all 8 box model lessons
- Each lesson includes 2-4 sentence beginner-friendly explanation
- ASCII diagrams illustrate the 4-layer box model structure
- Concepts cover: box model layers, padding vs margin, border position, box-sizing, margin collapse, shorthand notation, and individual border sides
- All concepts follow schema requirements (explanation required, diagram optional)
2026-01-11 05:13:11 +01:00
39f1fb5fae auto-claude: 3.3 - Add explanations for CSS selector specificity and cascade
Added 'concept' objects to 4 lessons in basic selectors module:
- Type + ID: Explains specificity boost from combining selectors
- Selector Lists: Explains OR logic and independent matching
- Universal Selector: Explains wildcard matching and descendant context
- Specificity: Explains cascade and point system for selector precedence

All concepts include beginner-friendly explanations (2-4 sentences) and ASCII diagrams showing how selectors match elements and resolve conflicts.
2026-01-11 05:07:49 +01:00
29c019bde5 auto-claude: 3.2 - Add conceptual explanations to CSS Grid lessons
- Added 'concept' objects to all 6 Grid lessons
- Explanations cover 2D grid system, tracks, and cell placement
- ASCII diagrams illustrate grid layouts, spanning, and overlapping
- Clear container vs item distinctions for each property
- Lessons: grid basics, template areas, spanning, auto-fit, alignment, overlapping
- All concepts follow schema (explanation required, diagram and containerVsItem optional)
- JSON validated successfully
2026-01-11 04:48:11 +01:00
0cf25b61b1 auto-claude: 3.1 - Add 'concept' objects to all 6 Flexbox lessons. Explicitly explain container vs item distinction. Include simple ASCII diagrams showing axis direction. 2026-01-11 04:43:59 +01:00
9e7781ada6 docs: update progress for completed subtask 2.4 2026-01-11 04:40:46 +01:00
3c08b45b6a feat: add whyThisWorks translation key for concept section
Add 'Why This Works' translation key to all 6 supported languages (en, de, pl, es, ar, uk) for the new concept section UI in lessons.
2026-01-11 04:40:21 +01:00
e21bca16a8 feat: populate concept section in renderLesson function
- Add logic to populate concept explanation, diagram, and containerVsItem fields
- Show concept section when concept data exists, hide when not defined
- Clear optional fields to prevent stale data from previous lessons
- Use textContent for text fields and innerHTML for diagram (SVG support)
2026-01-11 04:38:52 +01:00
49740f877d Update progress tracking for subtask 2.2 completion 2026-01-11 04:36:22 +01:00
0e39cffccb auto-claude: 2.2 - Add CSS styles for the concept panel: distinct vis 2026-01-11 04:35:27 +01:00
2a9565cff6 auto-claude: 2.1 - Add native <details><summary> element for Why This Works section 2026-01-11 04:32:41 +01:00
4486078599 feat: add concept field to lesson schema
Add 'concept' object to lesson schema with:
- explanation: required string for 2-4 sentence concept explanation
- diagram: optional string for SVG/ASCII art diagrams
- containerVsItem: optional string for Flexbox-specific distinctions
2026-01-11 04:29:07 +01:00
760690cdf1 test: update tests for new features and fix test expectations
Some checks failed
Deploy static content to Pages / deploy (push) Has been cancelled
2026-01-07 14:16:51 +01:00
fbe0f20ef7 feat: add reset code confirmation dialog with skip option
- Add dialog to confirm resetting code to initial state
- Allow users to skip confirmation with "don't show again" checkbox
- Save preference to user settings
- Improve i18n and CodeEditor components
2026-01-07 14:16:45 +01:00
52abfb37db fix(lessons): improve validation completeness and best practices
- 00-basic-selectors: add missing validation message, fix semicolons
- 05-units-variables: replace hex color with named color, use round numbers
- 08-responsive: rename "Flex Grids" to "Responsive Grid" for clarity
- 24-html-progress-meter: add missing high/max/optimum validations
- 32-html-svg: add comprehensive attribute validations for SVG elements
2026-01-07 14:16:16 +01:00
f050c1dcb9 fix: change transitions-animations difficulty to intermediate
Content is more advanced than beginner level, update difficulty label.
Also improve code examples in descriptions.
2026-01-07 14:15:25 +01:00
26999b4f05 fix: update English box-model task instructions format
Apply same task instruction format update to English source file.
2026-01-07 14:15:12 +01:00
110a677410 docs: update README internationalization section
- Document localized lesson directories (ar, de, es, pl, uk)
- Update copyright year to 2026
2026-01-07 14:14:51 +01:00
1236b5e114 chore: update copyright year 2025 -> 2026 in lessons
Update copyright year in semantic-containers lesson example
across all language versions.
2026-01-07 14:14:43 +01:00
95f2a81e64 fix(i18n): update box-model task instructions format
Update task instructions from old format to match English source:
- Old: "Add <kbd>padding: 1rem</kbd> to <kbd>.box</kbd>"
- New: "Set <kbd>padding</kbd> to <kbd>1rem</kbd>"

Removes redundant class name references since codePrefix shows the selector.
Affected languages: ar, es, pl, uk
2026-01-07 14:14:36 +01:00
c398fd3d5c chore: update format.lessons to include localized files
- Change glob pattern from lessons/*.json to lessons/**/*.json
- Update copyright year to 2026
2026-01-07 14:14:04 +01:00
b1ab23b579 feat(claude-code): add project settings and commands
- Add .claude/settings.json with permissions and hooks
- Add /format-lessons slash command
- Add .claude/settings.local.json to .gitignore
2026-01-07 14:13:59 +01:00
11f86c71f3 fix(lessons): style Hello World, add syntax examples, add goodbye module
Some checks failed
Deploy static content to Pages / deploy (push) Has been cancelled
- Hello World lesson now styles plain text (no h1 required)
- Added syntax examples to CSS Variables, calc(), Media Queries, Flexbox, Grid
- Added goodbye/offboarding module with contribution encouragement
2026-01-06 15:58:12 +01:00
0bc6e93390 fix(lessons): use code tags for quoted text, add syntax examples
Some checks failed
Deploy static content to Pages / deploy (push) Has been cancelled
- Fixed validation in welcome lesson (Hello World instead of Hello)
- Replaced 'quoted text' with <code>quoted text</code> in all task descriptions
- Added syntax examples to Transitions and Keyframes lessons
- Updated all language versions (en, de, pl, es, ar, uk)
2026-01-06 15:50:11 +01:00
8e892254f8 fix(i18n): align German lesson code with English
Some checks failed
Deploy static content to Pages / deploy (push) Has been cancelled
- Changed solution in 00-welcome.json from "Hallo Welt" to "Hello World"
- Added missing solution fields to 01-box-model.json (8 lessons)
- Added missing solution fields to 05-units-variables.json (4 lessons)
- Added missing solution fields to 06-transitions-animations.json (4 lessons)
- Added missing solution fields to 08-responsive.json (4 lessons)
- Fixed flexbox.json class names from .green/.red/.yellow to .box1/.box2/.box3
- Added missing solution fields to flexbox.json (6 lessons)

German translations now keep all CSS code in English for maintainability,
with only instructional text translated.
2026-01-06 14:58:49 +01:00
8d1a940588 fix(rtl): comprehensive layout fixes for Arabic
- Swap left/right panels in RTL mode
- Flip left panel border to left side
- Flip hint border to right side
- Flip lessons container indentation (margin, border, padding)
- Flip module expand icon and lesson checkmark margins
- Flip toggle switch slider margin
- Reverse setting row and preview controls
2025-12-31 10:31:49 +01:00