Architectural Evolution + Unified Shell EngineProformance

[hey-Zayn]

Summary by CodeRabbit

Release Notes

• New Features

  • Added error boundaries to gracefully handle and display app crashes with recovery options
  • New terminal commands: about, skills, projects, contact
  • Settings now includes option to reset all system data

• Improvements

  • File system automatically persists changes
  • Enhanced window management and stability
  • Improved desktop architecture for better performance and reliability

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
linux-next	Ready	Preview, Comment	Mar 16, 2026 2:22pm

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 2fe4b328-153b-4bdb-a76c-0d69a9d89c22

📥 Commits

Reviewing files that changed from the base of the PR and between a87ace2 and 68a30cc.

📒 Files selected for processing (16)

• .github/workflows/ci.yml
• src/app/page.tsx
• src/components/desktop/app-gallery.tsx
• src/components/desktop/dock.tsx
• src/components/desktop/file-explorer.tsx
• src/components/desktop/music-player.tsx
• src/components/desktop/settings.tsx
• src/components/desktop/terminal.tsx
• src/components/desktop/top-bar.tsx
• src/components/desktop/window.tsx
• src/components/ui/error-boundary.tsx
• src/context/DesktopContext.tsx
• src/hooks/use-command-handler.ts
• src/hooks/use-file-system.ts
• src/hooks/use-window-manager.ts
• src/lib/file-system.ts

---

📝 Walkthrough

Walkthrough

Introduces a context-driven architecture for desktop state management by adding DesktopContext with FileSystemContext and WindowManagerContext. Migrates components from prop-based to context-based APIs. Adds useFileSystem hook with localStorage persistence, useWindowManager hook for window lifecycle, and ErrorBoundary for error handling. Includes GitHub Actions CI workflow and new terminal commands.

Changes

Cohort / File(s)	Summary
CI Infrastructure .github/workflows/ci.yml	Adds GitHub Actions workflow triggering on push/PR to main/master. Runs checkout, Node.js 20 setup, npm ci, and lint/typecheck scripts on ubuntu-latest.
Context & Provider Architecture src/context/DesktopContext.tsx	New context module centralizing FileSystemContext and WindowManagerContext. Exports DesktopProvider, useFileSystemContext, useWindowManagerContext, useDesktop, and re-exports App/AppId/WindowInstance types.
Custom Hooks src/hooks/use-file-system.ts, src/hooks/use-window-manager.ts	Introduces useFileSystem hook with localStorage persistence, debounced saves, and file operations (create/delete/rename/save). Introduces useWindowManager hook managing window lifecycle (open/close/minimize/maximize/bringToFront) with zIndex tracking and special handling for editor/home windows.
Command Handler Enhancement src/hooks/use-command-handler.ts	Adds new terminal commands (about, skills, projects, contact) with formatted output blocks; refactors to use dedicated command executor from new hook.
File System Utilities src/lib/file-system.ts	Introduces zod schemas for File and Directory with recursive validation; exports FileSchema and DirectorySchema for runtime validation.
Error Handling src/components/ui/error-boundary.tsx	New ErrorBoundary class component with fallback UI, error logging, restart capability, and stack trace display in development mode.
Desktop Components Migration src/components/desktop/app-gallery.tsx, src/components/desktop/dock.tsx, src/components/desktop/file-explorer.tsx	Migrate from prop-based to context-driven APIs. AppGallery simplifies signature to recentApps only; Dock becomes memoized with no props; FileExplorer reduces to currentPath parameter, deriving state/actions from context.
Additional Component Migrations src/components/desktop/music-player.tsx, src/components/desktop/terminal.tsx, src/components/desktop/top-bar.tsx, src/components/desktop/window.tsx	MusicPlayer and Settings obtain fileSystem via useDesktop context. Terminal delegates command execution to useCommandHandler. TopBar becomes memoized const. Window wraps content in ErrorBoundary.
Settings UI Enhancement src/components/desktop/settings.tsx	Adds Danger Zone section with Reset All System Data button wired to resetFileSystem; refines theme reset button label.
Page Component Refactor src/app/page.tsx	Migrates to context-driven architecture. Introduces DesktopProvider and DesktopContent composition. Exports AppId, App, WindowInstance types. Removes local state for windows/gallery/file system; uses context hooks instead. Introduces dynamic app imports and BASE_APPS registry.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Poem

🐰 A rabbit's ode to context flow:
Props once scattered, now they flow
Through contexts deep, where contexts glow
Windows dance with zIndex's show
Files persist in localStorage's row
Errors caught before they grow
Architecture blooms—what a show! 🌱

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch UB-01

📝 Coding Plan

• Generate coding plan for human review comments

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

Tip

CodeRabbit can generate a title for your PR based on the changes with custom instructions.

Set the reviews.auto_title_instructions setting to generate a title for your PR based on the changes in the PR with custom instructions.