Space Works product rules

The general rules every product in the Space Works organisation follows. They are written for any product: the Django app (SpaceWorks), the Next.js apps (Workspace, Events, Machines, Inventory, Bookings, Organization), the native apps (Android, iOS), the website, the docs and this design system. They were collected from each repository’s README, CLAUDE.md / AGENTS.md, contributing guides and docs.

Each rule has the same parts: Rule, Why, How to apply, Across the org (what each product does today, and where one does not follow the rule yet). A rule that says “not checked” means we have not read the code for that product; it is not a claim either way.

The products, for short:

Product	What it is	Stack
SpaceWorks	The main makerspace platform (inventory, loans, machines, events, bookings, membership, payments, reports, installer)	Django + DRF, React, PostgreSQL, Redis, Celery
Workspace	Internal workspace for maker organisations (projects, chat, docs, files, finance, assistant)	Next.js, Prisma, PostgreSQL
Events	Event pages, registration, QR tickets, check-in, ID cards, certificates	Next.js, Prisma, PostgreSQL
Machines	Machine catalogue, job queue, pricing, repairs, maintenance, printer connections	Next.js, Prisma, PostgreSQL
Inventory	Stock room and lending desk with photo-evidence handovers	Next.js, Prisma, PostgreSQL
Bookings	Rooms, studios, desks and halls	Next.js, Prisma, PostgreSQL
Organization	Memberships, plans, renewals, receipts, ID cards	Next.js, Prisma, PostgreSQL
Android / iOS	Native member and staff apps	Kotlin, Jetpack Compose, Material 3 / Swift, SwiftUI
Website, Docs	Landing page (static HTML) and docs site (Astro Starlight)	static / Astro
SpaceWorks-Design-System	This repository: brand, tokens, fonts, motion, UX specs; site at https://spaceworks-labs.github.io/SpaceWorks-Design-System/	tokens / Starlight site

On this topic

Stack, install and hosting The shared stack, the one-line install, VPS defaults, self-host versus managed, backups and upgrades.
Areas, roles and code size Areas and modules, role-based views, and the file-size and modularity rules.
6. Money and payments How charges, payments and the ledger are recorded.
Audit trails, logs and analytics Append-only audit, structured logs and privacy-respecting analytics.
API, mobile, tenancy and privacy The documented API the apps share, tenant scoping and personal data.
11. Language, accessibility, themes and motion Plain language, the accessibility floor, light and dark themes, and motion.
Testing, release, decisions and handover Tests with every change, docs, releases, the decisions ledger and handover notes.
14. CI/CD pipeline The pipeline every repository runs, stage by stage.
New-feature checklist The list to run before any new feature ships.
Where each product stands A rule-by-product matrix of what follows the rules today.
Bring each product up to the rules The work left, product by product.