Dit is geen platte handleiding maar documentatie in vier lagen, voor vier lezers: wie het gebruikt, wie het idee wil begrijpen, wie het bouwt, en wie verder wil. Elke laag draagt een label dat zegt hoe lang hij meegaat.
shared/app-registry.ts) en wordt door een drift-toets bewaakt.Laag 1 — voor de gebruiker1Wat je ermee doet — de apps beweegt met de code
Op swarp.nl log je in met een magische link per e-mail (geen wachtwoord) en kom je op het startscherm: negen kaarten met apps. Een nieuw account begint met Profiel, AYYA360 en Community; in de App Store zet je apps aan of uit. Elke app beantwoordt één vraag — die staat hieronder cursief. Domein-apps dragen ook hun draad-naam uit het weefsel (laag 2).
- ProfielstandaardWie ben ik hier — en wat weet SWARP van mij?Jouw account, tijdlijn, data en plek in de wereld./profile · /mijn-tijdlijn · /mijn-plek · /connecties
- Wat zegt mijn geboorteblauwdruk over mijn dag en mijn pad?Oerlicht — levensloop, Human Design, heldentocht, daghoroscoop./ayya360 · /levensloop · /heldentocht · /daghoroscoop · /hd · /compatibiliteit · /coach
- Swarp Zingevingdraad: SpectrumWaar vind ik verdieping, teksten en gelijkgestemden?Eén licht, vele kleuren — zwaartepunten (SSP), gemeenschappen, filosofen, verdieping./spirituele-hub · /spiritueel-profiel · /spinoza · /filosofen · /bijbelkring
- Swarp PoCdraad: PrismaHoe kijk ik naar de wereld — en hoe veranderen mensen van kijk?Eén persoon door een prisma — persoonlijkheidsinzicht, functiematching, compatibiliteit (PoC)./functies · /verandermethodes
- Wat laat de spiegel van mijn samenhang vandaag zien?Live Ψ²=E²−p²−m² en de scheppende Magische Kamer./spiegel · /magische-kamer
- Swarp Thuisdraad: KettingboomWat weet ik van mijn woning — en wat kan ik ermee?De balk waar alle draden vandaan komen — woning, ruimtes, apparaten, energie.
- Swarp Kidsdraad: SpoelWat past bij mijn kind, thuis en op school?De kern waaromheen het garen wikkelt — kinderen, gezin, opvoeding, school./swarp-kids · /mijn-kind · /kids-school
- Hoe staat ons gezin ervoor als geheel?Gezin, familie en naasten — pedagogisch composite-rapport.
- Swarp Werkdraad: InslagHoe regel ik mijn werk, klussen en administratie als zelfstandige?De bewegende draad door de structuur — fiscaal, opdrachten, certificering, vakmensen./zzp-tools · /fiscaal · /opdrachtenmarkt · /vakmensen · /collectief
- Welk beroep past bij wie ik ben?BeroepsKompas: 1.016 beroepen met RIASEC-matching.
- Wat heb ik bijgedragen — en wat leverde het op?Seeds virtuele valuta, beloningen en mandaat-delegatie./seeds · /rewards · /delegations
- Swarp Politiekdraad: ScheringWie beslist er over mij — en waar sta ik zelf?De vaste lengtedraden — lokale democratie, partijen, burgerinitiatieven, raadsinformatie./mijn-politiek · /partijen · /gemeenten · /raadslid · /initiatieven · /burger-meldpunt
- Wat zijn mijn rechten — en waar vind ik antwoord?Digitale Rijdende Rechter en beleidsmonitor./vraagbaak · /juridische-monitor
- Agorafunctie-appWat vertellen de blogs van Constable Research — in beeld?Alle blogs van constable.blog op één plein, met dia-visualisaties per blog; elke telbewering op een dia is machinaal getoetst, elke duiding als lezing gemerkt. Interactieve pagina's (visuals) staan ernaast; de draden koppelen ze: motieven uit de visuals (commenda, VOC, gilde, box 3 …) worden letterlijk in alle blogteksten geteld — op de Agora als motief-keuze, in elke visual per station ("dit station in de blogs", diepe link
#station-n), en onder elke blog als "draden naar andere blogs" (/api/agora/motieven). - Swarp Academiedraad: VonkWaar kan ik leren wat ik wil leren?Kennisoverdracht als vonkoverslag — blog, academische hub, kennisbank, virtuele school./academia · /blog · /lexicon · /leerpad · /virtual-school · /conservatorium
- Ontdek Talentdraad: TalentWelk talent zit er in mij verborgen?Vind andere talenten in het netwerk, deel je atelier, doe mee aan de Agora./rtalent · /ontdek-talent
- Essaysvanaf niveau intermediateWaarom is SWARP gebouwd zoals het gebouwd is?Lange-vorm essays over de SWARP-architectuur en theorie./essay · /essay-quaternion · /essay-spiral · /essay-markov
- Swarp Gezonddraad: DauwHoe gaat het écht met me — en wat helpt?Herstel en ochtendlicht — gezondheid, therapie, vrije tijd./welzijn · /dokter · /therapie-studio · /vrije-tijd
- Swarp Atelierdraad: PatroonWaar maak en deel ik kunst?Het zichtbare beeld dat het weefsel toont — kunst, eigen werk, beeld en woord./kunstenaar · /tv
- Swarp Hobbydraad: KnoopWat doe ik graag — en met wie?De speelse vlecht in de draad — hobby's, passies, lotgenoten op interesse.
- Wie zijn hier — en wat bespreken we samen?Wat ontstaat als alles samenkomt — feed, groepen, berichten, bijeenkomsten (altijd actief). Het forum is gedeeld met Support en Leefomgeving./feed · /forum · /groups · /messages · /meetings · /hubs
- Het laboratorium: welke experimenten brengen SWARP verder?De draad die je eerst beproeft — onderzoek, experiment, sandbox, code-projecten./research · /sandbox · /triz · /future-forge
- Systeem & AIDENniveau expertOnder de motorkap: hoe draaien de motoren van het platform?Platform-internals: agents, coherentie, surprisals, AIDEN./system · /system-agent · /coherence · /surprisals
- Beheerrol: beheerder / ambassadeurBeheer voor de platformeigenaar.Beheertaken voor ambassadeurs en beheerders./admin/ambassador-requests · /admin/announcement · /admin/data-sync · /admin/zaadbank
Laag 2 — voor de denker2Het idee & de filosofie blijvend
SWARP is een burgersysteem van onderop: het doel is dat je weet wat er lokaal speelt en dat je de mensen om je heen kunt vinden — per wijk en woonplaats. Alles begint bij de persoon, niet bij de instelling.
Het beeld dat het platform draagt is het weefgetouw. Elk domein is een draad met een eigen rol in het weefsel, en de dertien draden samen vormen het doek. De namen zijn geen versiering — ze zeggen wat een draad dóet:
- Bron (AYYA360) — het oerlicht, de blauwdruk waaruit alles begint
- Schering (Politiek) — de vaste lengtedraden van de lokale democratie
- Inslag (Werk) — de bewegende draad door de structuur
- Spoel (Kids) — de kern waaromheen het garen wikkelt
- Vonk (Academie) — kennisoverdracht als vonkoverslag
- Prisma (PoC) — één persoon door een prisma
- Spectrum (Zingeving) — één licht, vele kleuren
- Dauw (Gezond) — herstel en ochtendlicht
- Patroon (Atelier) — het zichtbare beeld dat het weefsel toont
- Knoop (Hobby) — de speelse vlecht in de draad
- Kettingboom (Thuis) — de balk waar alle draden vandaan komen
- Proefdraad (Lab) — de draad die je eerst beproeft
- Weefsel (Community) — wat ontstaat als alles samenkomt
Onder de draden liggen twee modelkeuzes die het hele platform dragen en niet zonder besluit worden losgelaten: de octonion-kosmologie met het vrije-energieprincipe (FEP) als modelgrondslag, en de nilpotente Rowlands-kern (Ψ²=E²−p²−m²) als harde beperking: elke verandering van toestand — door een mens óf door de platformagent AIDEN — moet door dezelfde poort, met dezelfde handtekening. Dat is geen prompt maar code; het houdt mens en machine symmetrisch.
- 1Van onderop. De burger staat centraal; een instelling (raadsinformatie, een bron) is een mogelijke leverancier, geen afhankelijkheid.
- 2Geen doodlopende schermen. Elk betekenisdragend woord — een draad, een kleur, een partij, een gemeente, een type — linkt door naar een diepere plek. Een doodlopende weg knapt de draad die de gebruiker volgt.
- 3Eén begrip, één bron. Hetzelfde begrip heeft op één plek zijn waarheid; al het andere leest. Een tweede muteerbare bron naast een canonieke is een architectuurfout, geen gemak.
- 4Postcode is de waarheid van plaats. Waar je bent volgt uit je postcode (via PDOK); losse gemeente- of wijkkolommen zijn schaduwen.
- 5De poort is symmetrisch. Mens en AIDEN gaan door dezelfde nilpotente bewaker; afgewezen veranderingen worden per as (BLUE/RED/GREEN/YELLOW) vastgelegd.
Extended is het weefsel als geheel; de andere leden van de familie zijn er delen van die op eigen benen kwamen te staan: de MAZE-Bank (het boek van de kring), Weather (het buitenweer), Leefomgeving (de kaart van je plek), Support (de menskant), en de MAZE (het geheugen waarop alles rust).
Laag 3 — voor de bouwer3Hoe het werkt — de software beweegt met de code
Extended is één proces: een Express 5-server die de API én de React 18-app (Wouter, TanStack Query, Tailwind, shadcn/ui) serveert, uit één monorepo. Ongeveer 117 routers — één per functie — en zo'n 200 pagina's; gedeelde code in shared/, met het datamodel per draad (shared/schema/<draad>.ts) en de weefgetouw-vertelling voor de AI-prompts.
De motoren
- App-registry —
shared/app-registry.tsis de bron van het startscherm: negen categorieën, de apps, hun routes; wat een account heeft aanstaan, staat inuser_settings.activeApps. Laag 1 hierboven leest rechtstreeks uit die registry. - Hub-engine — één polymorfe tabel
hubs(wereld × schaal × slug) drijft alle 8 werelden × 3 schalen aan; geen aparte tabellen per wereld. - Nilpotente kern —
server/nilpotent-kernel/: de Rowlands-algebra, de HD-fermion-projectie en de herschrijf/bewaker-machine waar elke toestandsverandering doorheen moet (runGuarded). - AIDEN — de autonome platformagent (
server/system-agent.ts) met dezelfde bewaker als de mens. - FEP-Schank-leerlus — navigatie leert van gebruik: route-tags (PoC, RIASEC, draad-vector), een voorspeller van volgende stappen en de gids "Swarpie".
- Postcode-resolver —
GET /api/postcode/:pc4met PDOK als terugval; de enige bron van plaats. - Inloggen — uitsluitend de magische link per e-mail (Resend); sessie gedeeld over de familie op
.swarp.nl. - Voor agenten — een MCP-server en een kleine SDK (
mcp-server/,sdk/).
Bouwen en draaien
npm run dev (ontwikkeling), npm run build + npm start (productie, één bundel), npm run check (typen), npx vitest (toetsen). Schema-wijzigingen gaan als idempotente raw-SQL-startmigraties onder een advisory lock — de database wordt gedeeld met Support en Weer, dus db:push draait bewust niet in de build. Uitrol op Render als dienst swarp, domein swarp.nl.
Laag 4 — voor de verbinder4Links, bronnen & verder beweegt met de code
- de dienstswarp.nl — het startscherm; App Store om apps aan of uit te zetten; in-app hulp.
- de familieMAZE-Bank · Weather · Leefomgeving · Support · de MAZE.
- de theorieDe essays in de app (/essay en verder) — over het weefgetouw, de quaternionen, de spiraal, de Markov-navigatie.
- de bron van laag 1
shared/app-registry.tsenshared/domain-config.ts— bewaakt doornode maze/handleiding-drift.mjs: elke app in de registry moet hier staan. - terugalle handleidingen.