Developers
Architecture
Five open-source pieces that make up a Shellui stack. Use all of them, or keep the frontend and swap authentication and storage for Supabase.
Shellui uses a microservice architecture. Each project has its own lifecycle and is managed as an individual repository, but all of them serve the Shellui frontend. Authentication and storage are designed to be replaceable with Supabase if that is already in your stack.
Shellui Frontend
The frontend lives in the shellui monorepo, a TypeScript React runtime. @shellui/core owns navigation, layout modes, themes, i18n, modals, and drawers. @shellui/sdk lets apps in iframes talk to the shell. @shellui/cli scaffolds and serves projects. Any stack can run inside the Shellui iframe.
Stack TypeScript React React Router shadcn Tailwind Workbox Roarr Sentry
shellui/shellui (opens in a new tab)
Authentication Backend
The default backend is identity-service, a Django API for OAuth (GitHub, Google, Microsoft), JWT sessions, and JWKS verification. It ships as a Docker image and is deployed at id.shellui.com. You can replace it with Supabase Auth - the shell already supports both.
Stack Python Django django-allauth Django REST Framework Swagger ReDoc
shellui/identity-service (opens in a new tab) shellui/identity-service (opens in a new tab)
Administration Frontend
The admin panel is a Vite + React app embedded in the shell at /admin. It manages users, company access, and operational data. It is static files currently deployed at admin.shellui.com.
Stack TypeScript React React Router shadcn Tailwind
shellui/admin (opens in a new tab)
Storage Backend
The storage-service is a Django API with a Supabase-compatible Storage REST surface. Blobs go to S3 or the local filesystem. It ships as a Docker image and is deployed at storage.shellui.com. You can replace it with Supabase Storage.
Stack Python Django Django REST Framework django-storages Swagger ReDoc
shellui/storage-service (opens in a new tab) shellui/storage-service (opens in a new tab)
Files Frontend
Files is a React file manager app embedded in the administration iframe. It handles browsing, upload, download, folders, permissions, and share links. It is static files available at files.shellui.com.
Stack TypeScript React React Router shadcn Tailwind