SHADE
Inloggen, accounts, rechten, beheer, een HTTP-API, een auditlog en plugins, voor de kleine zaak die het draait.
- TypeScript
- Node
- Hono
- Nuxt 4
- Drizzle
- Postgres 18
- Valkey
- Docker
- Plugins: onvertrouwde draaien in een sandbox, vertrouwde zijn ondertekend en door een beheerder goedgekeurd.
- Het auditlog: elke wijziging, en wie die deed.
Plugins veilig laten draaien: onvertrouwde plugins draaien in een workerd-sandbox, en vertrouwde moeten ondertekend zijn en door een beheerder goedgekeurd. Iedereen kan plugins ondertekenen en installeren op een eigen host; er is geen sleutel die alleen RG Digital heeft.
Het probleem
Ik bouwde SHADE vanwege dashboards en CMS’en. Allebei hebben ze hun eigen doel, en allebei groeien ze er vaak overheen. Een dashboard begint als intern scherm om dingen te beheren en wordt uiteindelijk de API waar alle gegevens doorheen gaan. Een CMS begint als backend van een website, krijgt er een webshop bij, en kan op een gegeven moment niet meer mee.
SHADE (Self-Hosted Adaptive Data Engine) is open source software waarop een kleine zaak haar eigen systemen draait. Het brengt wat elk van die systemen nodig heeft: inloggen, accounts, rechten, beheer, een HTTP-API, een auditlog en plugins. Elk project voegt de plugins toe die het nodig heeft, en een eigen frontend.
Daarnaast heeft het koppelingen met externe diensten, en hulpmiddelen voor beveiliging van gegevens en privacy. Daarop bouw je plugins. Een plugin vraagt om de mogelijkheden die hij nodig heeft en krijgt alleen die, dus hij kan niet meer dan een beheerder toestond. Je schrijft alleen de logica die je toepassing nodig heeft, geen hele toepassing.
Randvoorwaarden
Eén installatie per zaak: één Docker-image met Postgres 18 en Valkey. Zaken delen niets met elkaar.
De zaak is volledig eigenaar van de installatie, zonder licentiesleutels. Iedereen mag het hosten, draaien en aanpassen. Het is self-hosted. RG Digital heeft het gebouwd, en je zit er nooit aan vast. Voor hulp bij SHADE zelf ga je naar het project.
Het is pre-release en valt onder de Apache-2.0-licentie. De repositories worden openbaar bij de eerste stabiele release.
Keuzes en waarom
Postgres is de enige database waarin gegevens echt worden bewaard. Valkey houdt alleen werk bij dat onderweg is, dus als dat wegvalt, gaan er geen gegevens verloren.
Plugins zijn er in twee soorten. Onvertrouwde plugins draaien in een workerd-sandbox; vertrouwde moeten ondertekend zijn en door een beheerder goedgekeurd. Iedereen kan plugins ondertekenen en installeren op een eigen host.
Elke keuze leg ik vast in een beslisdocument.
Wat er misging
Er ging niets echt stuk. De druk kwam van het bouwen samen met AI: elke functie, en elke verbinding tussen functies, moest veilig zijn en leesbaar blijven. Daarom is SHADE opgedeeld in zes lagen (kernel, foundation, content, publishing, management en entry), die elk alleen doen wat op hun niveau hoort. Onderdelen gebruiken alleen lagere lagen, en een architectuurtest weigert elke import die die indeling breekt.
Hoe het gebouwd is
Claude Code bouwt features van begin tot eind. Ik review elke pull request, neem de productkeuzes en leg ze vast in beslisdocumenten.