How brahimaann/sanktuary-os works
Sanktuary combines a public-facing Twin Cities arts and music hub with an invitation-only, Windows 98-style member desktop. The member workflow runs from sign-in and desktop launch through shared files, previews, and collaboration; the desktop also hosts creative and utility apps. The README documents music, community stories, apparel, and shared workspaces, while the sampled source gives firmer evidence for desktop, file, API, and live-event wiring. Several public-content and desktop-app branches are represented by their exact enclosing directories because their implementations were not sampled.
Main entry points: Desktop.tsx Desktop · api.ts API Client · FilePreview.tsx File Preview · TeamFiles.tsx Team Files
Components 19
Public Hub
- Arts & Music
src/apps - CITIES Journal
ops/nodes - Shop
src/apps
Member Desktop
- Sanktuary App
src/App.tsx - Desktop
src/components/Desktop.tsx - Window Manager
src/wm/manager.ts
Creative Workspaces
- Team Files
src/apps/TeamFiles.tsx - File Preview
src/apps/FilePreview.tsx - Moodboards
src/apps/Boards.tsx - Planner & Chat
src/apps - Creative Apps
src/apps - JS Paint
public/programs/jspaint/src/app.js
Platform Services
- API Client
src/utils/api.ts - Live Events
src/utils/live.ts - Virtual Filesystem
src/vfs/fs.ts - Node Server
server/index.mjs - Clerk Sign-in
Other components
- Visitor
- Member
Connections 22
- Visitor → Arts & Music: explores
- Visitor → CITIES Journal: reads
- Visitor → Shop: shops
- Member → Clerk Sign-in: signs in
- Member → Desktop: works in
- Clerk Sign-in → API Client: provides session
- Sanktuary App → Window Manager: reads windows
src/App.tsx - Sanktuary App → Desktop: renders
src/App.tsx - Desktop → Window Manager: opens windows
src/components/Desktop.tsx - Desktop → API Client: fetches member data
src/components/Desktop.tsx - Desktop → Live Events: starts connection
src/components/Desktop.tsx - Desktop → Virtual Filesystem: syncs notes
src/components/Desktop.tsx - Team Files → API Client: fetches files
src/apps/TeamFiles.tsx - Team Files → File Preview: opens preview
src/apps/TeamFiles.tsx - File Preview → Team Files: gets file URL
src/apps/FilePreview.tsx - File Preview → API Client: fetches metadata
src/apps/FilePreview.tsx - API Client → Node Server: sends API requests
src/utils/api.ts - Live Events → Node Server: receives events
src/utils/live.ts - Member → Moodboards: creates moodboards
- Member → Planner & Chat: collaborates
- Member → Creative Apps: uses apps
- Creative Apps → JS Paint: includes