Skip to content

Releases: variableway/innate-executable

v0.2.0 — Interactive Tutorials & GitHub Pages Deployment

04 May 06:39

Choose a tag to compare

What's New

This release adds a complete interactive tutorial system with executable code blocks, auto-discovery of tutorials via manifest generation, course management, and static site deployment to GitHub Pages.

Features

Interactive Tutorial System

  • Runnable Code Blocks: Standard Markdown fenced code blocks now automatically get a "Run" button for shell/bash scripts (Task 6, 7)
  • Platform Tabs: Multi-OS tutorials show macOS/Linux and Windows tabs with platform-specific scripts (Task 18)
  • Auto-runnable pre blocks: All standard Markdown code blocks are auto-detected and made executable without special MDX syntax
  • First-click fix: Run button now reliably executes commands on first click (Task 10)

Tutorial Content

  • Claude Code + GLM 5.1 + DeepSeek V4 installation tutorial (Task 2)
  • Kimi CLI installation tutorial with Mac/Windows support (Task 11)
  • Node.js installation with version management (fnm) (Task 12)
  • Git installation tutorial (Task 13)
  • AI Basics Series: Math fundamentals, cognitive science, cybernetics, causal inference, interdisciplinary journey (Task 15)
  • OpenClaw Series: 5-min experience, search & summarize, email & calendar, custom skills

Tutorial Infrastructure

  • Auto-discovery: Tutorials are auto-scanned from public/skills/ via generate-skills-manifest.mjs — no hardcoded skill lists (Task 17)
  • Course auto-generation: Courses are automatically created from skill categories in the manifest
  • Skill sorting: Course skill lists support up/down reordering with persistence (Task 21)

Deployment

  • GitHub Pages: Static site deploys automatically on push to main via GitHub Actions (Task 20)
  • basePath support: Correct /innate-executable/ base path for assets, routes, and fetch calls (Task 23)

UI/Theme

  • Warmer theme: Switched from neutral gray to warm stone/amber OKLCH color palette (Task 18)
  • Fixed course detail: Cleaned up UI overlap between progress bar and skill list (Task 20)

Bug Fixes

  • Fixed generateStaticParams missing param error for dynamic tutorial pages (Task 3, 4)
  • Fixed MDX acorn parse errors for code blocks containing curly braces and backticks (Task 7, 14)
  • Fixed PlatformTabs props being stripped by next-mdx-remote v6 security plugins (Task 18)
  • Fixed Module not found: Can't resolve './lib/utils' — file was ignored by .gitignore lib/ pattern (Task 22)
  • Fixed GitHub Pages deployment — all JS/CSS assets now use correct base path (Task 23)
  • Fixed 10 of 14 MDX tutorials that failed compilation due to unescaped quotes in JSX attributes
  • Added SSR guard to prevent window reference during static generation

Commits

  • bc27bb9 fix: add basePath for GitHub Pages deployment
  • d38e5e7 fix: force-track lib/utils.ts ignored by global lib/ gitignore rule
  • b660f8f fix: PlatformTabs code block display + warmer tutorial theme
  • 338aa2d feat: auto-runnable code blocks from standard Markdown fenced blocks
  • 8604539 fix: resolve MDX acorn parse error for code blocks with curly braces
  • 75a6e1d feat(tutorial): add Node.js and Git installation tutorials
  • 6218cf2 feat(tutorial): add Kimi Code CLI installation tutorial
  • fc8a312 fix: ensure first Run button click reliably executes commands in terminal
  • 66dcc3b feat(tutorial): add interactive Run button and platform tabs to MDX tutorials
  • ca5a205 Update workflow state: start tasks/issues/2-start-cc.md

🤖 Generated with Claude Code