Skip to content
Uvilo OS
archived Visibility internal Owner erik@uvilo.com Approver _ Created _ Updated _

Sidebar Reorg State

Status

Complete ✅

Output Summary

  • README.md — project landing page
  • Sidebar_Reorg_Requirements.md — concise project requirements
  • Sidebar_Reorg_Spec.md — ideal final outcome spec
  • Sidebar_Reorg_Plan_Implementation.md — complete implementation plan
  • Sidebar_Reorg_History.md — session summaries
  • Sidebar_Reorg_WIP.md — active session scratchpad
  • view_folder_config.json — generator configuration
  • Scripts/generate_view_pages.ts — the generator script

Todo

  • Create Sidebar Reorg project folder and project files
  • Write Sidebar Reorg requirements doc
  • Write Sidebar Reorg spec describing ideal final outcome only
  • Define implementation approach → Sidebar_Reorg_Plan_Implementation.md

Phase 1 — Infrastructure Setup

  • Create Architecture/Sidebar_Reorg/view_folder_config.json
  • Install tsx as a dev dependency in .internal/
  • Implement project scanner module in generate_view_pages.ts
  • Implement README generator module (overview, folder structure, parent/sub-project sections)
  • Implement file-view page generator module
  • Implement MEDIA.md generator module
  • Implement sidebar snippet generator module
  • Update content.config.ts — add .generated/ glob and update generateId
  • Update .internal/package.json — add tsx dev dep, add generate, update dev and build scripts
  • Add .generated/ to repo root .gitignore
  • Add generator script and config to sidebar in astro.config.mjs
  • Verify: astro check passes (0 errors, 0 warnings); astro build succeeds (153 pages)

Phase 2 — README Generation (First Run)

  • Run generator: npm run generate
  • Review and spot-check all 15 generated READMEs
  • Apply README slug additions to top of each project’s sidebar group in astro.config.mjs (preserve existing entries)
  • Commit all new README.md files and updated astro.config.mjs
  • Verify: Deploy to Vercel preview; confirm all project READMEs accessible

Phase 3 — Non-Markdown File Visibility

  • Run npm run build locally; confirm .generated/ populated with file-view pages (57 pages)
  • Spot-check Domain_Quiz .ts, Goodreads .html/.csv, Taxonomy .ts file-view pages
  • Confirm syntax highlighting renders in Starlight (via build output)
  • Confirm each project README links correctly to file-view slugs
  • Verify 500-line truncation on large Goodreads HTML files (16K+ lines)
  • Apply file-view page slug additions to each project’s sidebar group in astro.config.mjs
  • Commit updated astro.config.mjs
  • Verify: Navigate sidebar AND project READMEs in preview

Phase 4 — Media Folder Pages

  • Scan all Architecture projects for image files (found 1: Uvilo_Method/Media/Taxonomy_Screenshot.jpg)
  • Generate MEDIA.md for Uvilo_Method/Media/
  • Add MEDIA.md slug to sidebar
  • Verify: Confirm MEDIA.md page renders media preview

Phase 5 — Sidebar Completeness Review

  • Confirm all 15 Architecture project groups have a README slug at the top
  • Confirm all file-view page slugs from Phase 3 are present in the sidebar
  • Confirm MEDIA.md slug from Phase 4 is present
  • Identify any remaining non-Markdown files missed — all accounted for
  • Commit final astro.config.mjs
  • Verify: Full manual walk-through

Phase 6 — Build Integration & Final Verification

  • Verify Vercel build command invokes npm run build (which includes npm run generate)
  • Trigger full Vercel preview deployment; confirm file-view pages accessible
  • Confirm astro check passes; no type errors from generated content
  • Confirm starlightAutoSidebar plugin does not conflict with new structure
  • End-to-end test
  • Merge to dev; confirm production deployment at os.uvilo.com

Post-completion — Spec/Implementation Alignment

  • D1: Update spec — Parent Project / Sub-projects are not auto-generated; preserved on regen
  • D1: Update generator — remove subProjects/parentProject computation; preserve overview/parent/sub sections
  • D2: Update spec/requirements — IMAGES.md → MEDIA.md to match implementation
  • D3: Add 23 missing file-view sidebar entries to astro.config.mjs
  • D4: Update spec/requirements — document SKILL.md file-view exception
  • D5: Update spec — parent folder link = project README
  • Verify: astro check 0 errors; astro build succeeds (168 pages); 0 missing sidebar slugs