Administrator Guide

This handbook is the operator reference for the current Astro + React desktop shell.

What This Repo Runs Today

• Astro is the page router and build system.
• The interactive desktop shell is a client-loaded React app mounted through Wrapper.
• Reader windows are used for docs, handbook, and blog routes.
• The desktop currently includes site-index.sys, Resume, Update Center, Reader, Presentation, Record Library, Our Record Library, Recipes A Taste of Home, and Wildlife Archive.
• Decap CMS powers the local admin portal at /admin.

Main Admin Areas

• Deploy: /handbook/admin/deploy
• Content authoring: /handbook/admin/content-authoring
• Mobile shell spec: /handbook/admin/mobile-shell
• Requirements memory: /handbook/admin/requirements-memory
• Window manager: /handbook/admin/window-manager
• State & persistence: /handbook/admin/state-persistence

Practical Notes

• Reset OS State clears local desktop and window storage and then reloads the current route.
• If the current URL is a Reader-managed route like /blog, /docs, or /handbook, the Reader will reopen after reload because the route bootstrapper restores that state from the URL itself.
• The Astro dev toolbar is intentionally disabled in local development; React DevTools is the useful inspector for the shell.

For questions, open an issue in GitHub or update this handbook when behavior changes.