This is not a flat manual but documentation in four layers, for four readers: whoever uses it, whoever wants to grasp the idea, whoever builds it, and whoever wants to go further. Each layer carries a label saying how long it lasts.
shared/app-registry.ts) and is guarded by a drift check.Layer 1 — for the user1What you do with it — the apps tracks the code
On swarp.nl you log in with a magic link by email (no password) and land on the home screen: nine cards of apps. A new account starts with Profile, AYYA360 and Community; in the App Store you switch apps on or off. Every app answers one question — shown in italics below. Domain apps also carry their thread name from the fabric (layer 2). App names are given as they appear on the Dutch platform.
- Who am I here — and what does SWARP know about me?Your account, timeline, data and place in the world./profile · /mijn-tijdlijn · /mijn-plek · /connecties
- What does my birth blueprint say about my day and my path?Primordial light — life path, Human Design, hero's journey, daily horoscope./ayya360 · /levensloop · /heldentocht · /daghoroscoop · /hd · /compatibiliteit · /coach
- Swarp Zingeving Meaning · thread: SpectrumWhere do I find depth, texts and kindred spirits?One light, many colours — gravities (SSP), communities, philosophers, depth./spirituele-hub · /spiritueel-profiel · /spinoza · /filosofen · /bijbelkring
- Swarp PoCthread: PrismHow do I look at the world — and how do people change their view?One person through a prism — personality insight, function matching, compatibility (PoC)./functies · /verandermethodes
- Spiegel & Kamer Mirror & ChamberWhat does the mirror of my coherence show today?Live Ψ²=E²−p²−m² and the generative Magic Chamber./spiegel · /magische-kamer
- Swarp Thuis Home · thread: Warp BeamWhat do I know about my home — and what can I do with it?The beam from which all threads originate — home, rooms, devices, energy.
- Swarp Kidsthread: SpoolWhat fits my child, at home and at school?The core around which the yarn winds — children, family, parenting, school./swarp-kids · /mijn-kind · /kids-school
- Gezin FamilyHow is our family doing as a whole?Family and loved ones — pedagogical composite report.
- Swarp Werk Work · thread: WeftHow do I run my work, gigs and admin as a freelancer?The moving thread through the structure — tax, assignments, certification, professionals./zzp-tools · /fiscaal · /opdrachtenmarkt · /vakmensen · /collectief
- Beroepen ProfessionsWhich occupation fits who I am?Profession compass: 1,016 professions with RIASEC matching.
- Seeds & Beloningen Seeds & RewardsWhat have I contributed — and what did it yield?Seeds virtual currency, rewards and mandate delegation./seeds · /rewards · /delegations
- Swarp Politiek Politics · thread: WarpWho decides about me — and where do I stand myself?The fixed lengthwise threads — local democracy, parties, citizen initiatives, council info./mijn-politiek · /partijen · /gemeenten · /raadslid · /initiatieven · /burger-meldpunt
- Vraagbaak & Recht Legal HelpWhat are my rights — and where do I find answers?Digital legal advisor and policy monitor./vraagbaak · /juridische-monitor
- Agorafunction appWhat do the Constable Research blogs tell — visually?All constable.blog posts on one square, with slide visualisations per blog; every count on a slide is machine-checked, every interpretation marked as a reading. Interactive pages (visuals) sit alongside; the threads connect them: motifs from the visuals (commenda, VOC, guild, box 3 …) are counted verbatim across all blog texts — on the Agora as a motif picker, in each visual per station ("this station in the blogs", deep link
#station-n), and under every blog as "threads to other blogs" (/api/agora/motieven). - Swarp Academie Academy · thread: SparkWhere can I learn what I want to learn?Knowledge transfer as spark-jump — blog, academic hub, knowledge base, virtual school./academia · /blog · /lexicon · /leerpad · /virtual-school · /conservatorium
- Ontdek Talent Discover Talent · thread: TalentWhat talent is hidden in me?Find other talents in the network, share your atelier, join the Agora./rtalent · /ontdek-talent
- Essaysfrom level intermediateWhy is SWARP built the way it is built?Long-form essays on the SWARP architecture and theory./essay · /essay-quaternion · /essay-spiral · /essay-markov
- Swarp Gezond Health · thread: DewHow am I really doing — and what helps?Recovery and morning light — health, therapy, leisure./welzijn · /dokter · /therapie-studio · /vrije-tijd
- Swarp Atelierthread: PatternWhere do I make and share art?The visible image the fabric shows — art, own work, image and word./kunstenaar · /tv
- Swarp Hobbythread: KnotWhat do I love doing — and with whom?The playful braid in the thread — hobbies, passions, peers by interest.
- Who is here — and what do we discuss together?What emerges when everything meets — feed, groups, messages, meetings (always active). The forum is shared with Support and Living Environment./feed · /forum · /groups · /messages · /meetings · /hubs
- The laboratory: which experiments push SWARP forward?The thread you test first — research, experiment, sandbox, code projects./research · /sandbox · /triz · /future-forge
- Under the hood: how do the platform's engines run?Platform internals: agents, coherence, surprisals, AIDEN./system · /system-agent · /coherence · /surprisals
- Beheer Adminrole: admin / ambassadorAdministration for the platform owner.Management tasks for ambassadors and admins./admin/ambassador-requests · /admin/announcement · /admin/data-sync · /admin/zaadbank
Layer 2 — for the thinker2The idea & the philosophy enduring
SWARP is a bottom-up citizen system: the goal is that you know what is happening locally and can find the people around you — per neighbourhood and town. Everything begins with the person, not the institution.
The image the platform carries is the loom. Each domain is a thread with its own role in the fabric, and the thirteen threads together make the cloth. The names are not decoration — they say what a thread does:
- Source (AYYA360) — the primordial light, the blueprint from which everything begins
- Warp (Politics) — the fixed lengthwise threads of local democracy
- Weft (Work) — the moving thread through the structure
- Spool (Kids) — the core around which the yarn winds
- Spark (Academy) — knowledge transfer as spark-jump
- Prism (PoC) — one person through a prism
- Spectrum (Meaning) — one light, many colours
- Dew (Health) — recovery and morning light
- Pattern (Atelier) — the visible image the fabric shows
- Knot (Hobby) — the playful braid in the thread
- Warp Beam (Home) — the beam from which all threads originate
- Test Thread (Lab) — the thread you test first
- Fabric (Community) — what emerges when everything meets
Beneath the threads lie two modelling choices that carry the whole platform and are not dropped without a decision: octonion cosmology with the free-energy principle (FEP) as the modelling foundation, and the nilpotent Rowlands kernel (Ψ²=E²−p²−m²) as a hard constraint: every change of state — by a human or by the platform agent AIDEN — must pass the same gate, with the same signature. That is code, not a prompt; it keeps human and machine symmetric.
- 1Bottom-up. The citizen is central; an institution (council information, a source) is a possible supplier, not a dependency.
- 2No dead-end screens. Every meaningful token — a thread, a colour, a party, a municipality, a type — links on to a deeper place. A dead end snaps the thread the user follows.
- 3One concept, one source. The same concept has its truth in one place; everything else reads. A second mutable source beside a canonical one is an architectural fault, not a convenience.
- 4Postcode is the truth of place. Where you are follows from your postcode (via PDOK); loose municipality or district columns are shadows.
- 5The gate is symmetric. Human and AIDEN pass the same nilpotent guard; rejected changes are recorded per axis (BLUE/RED/GREEN/YELLOW).
Extended is the fabric as a whole; the other members of the family are parts of it that came to stand on their own feet: the MAZE-Bank (the book of the circle), Weather (the outer weather), Living Environment (the map of your place), Support (the human side), and the MAZE (the memory everything rests on).
Layer 3 — for the builder3How it works — the software tracks the code
Extended is one process: an Express 5 server serving the API and the React 18 app (Wouter, TanStack Query, Tailwind, shadcn/ui) from one monorepo. About 117 routers — one per feature — and some 200 pages; shared code in shared/, with the data model per thread (shared/schema/<thread>.ts) and the loom narrative for the AI prompts.
The engines
- App registry —
shared/app-registry.tsis the source of the home screen: nine categories, the apps, their routes; what an account has switched on lives inuser_settings.activeApps. Layer 1 above reads straight from that registry. - Hub engine — one polymorphic table
hubs(world × scale × slug) powers all 8 worlds × 3 scales; no bespoke tables per world. - Nilpotent kernel —
server/nilpotent-kernel/: the Rowlands algebra, the HD-fermion projection and the rewrite/guard machine every state change passes through (runGuarded). - AIDEN — the autonomous platform agent (
server/system-agent.ts) with the same guard as the human. - FEP-Schank learning loop — navigation learns from use: route tags (PoC, RIASEC, thread vector), a next-step predictor and the guide "Swarpie".
- Postcode resolver —
GET /api/postcode/:pc4with PDOK as fallback; the only source of place. - Login — the magic link by email only (Resend); session shared across the family on
.swarp.nl. - For agents — an MCP server and a small SDK (
mcp-server/,sdk/).
Building and running
npm run dev (development), npm run build + npm start (production, one bundle), npm run check (types), npx vitest (tests). Schema changes go as idempotent raw-SQL startup migrations under an advisory lock — the database is shared with Support and Weather, so db:push deliberately does not run in the build. Deployed on Render as service swarp, domain swarp.nl.
Layer 4 — for the connector4Links, sources & further tracks the code
- the serviceswarp.nl — the home screen; App Store to switch apps on or off; in-app help.
- the familyMAZE-Bank · Weather · Living Environment · Support · the MAZE.
- the theoryThe essays in the app (/essay and onward) — on the loom, the quaternions, the spiral, the Markov navigation.
- source of layer 1
shared/app-registry.tsandshared/domain-config.ts— guarded bynode maze/handleiding-drift.mjs: every app in the registry must appear here. - backall manuals.