Personal Operating System for Sovereign Data
A experimental system to claim ownership of your data. Centralises data from multiple fragmented sources into a single, offline-first, portable graph that belongs entirely to you.
Most digital life scatters across dozens of platforms. Your data lives inside corporate servers, bound by terms-of-service, inaccessible when you need it, gone when you don't.
Refarm's hypothesis: What if you could own, control, and transport your data like you own your files?
We're exploring this through:
- Offline-first storage — data lives in your browser, not corporate servers
- Plugin architecture — extend via client-side WASM, fully agnostic of registries
- Open formats — everything is JSON-LD, portable to any platform
- Pragmatic decentralisation — Designed for agnostic identity & discovery; future-proof for protocols like Nostr, while maintaining local-first simplicity.
Refarm is a unified architecture that manifests as distinct experiences depending on the domain used to access it. All domains run the same core engine but curate different capabilities:
refarm.dev: The core engine, SDKs, and developer portal.refarm.me: The sovereign identity and private "Second Brain" interface.refarm.social: The public network, federated communities, and P2P gardens.
🚧 Core Alignment & Architectural Stabilization
Refarm is transitioning from an experimental research project to a stable, modular engine. We are currently formalizing the emergence of its core primitives into a cohesive, auditable system.
- Current phase: Phase 6 - Sync & Execution Stabilization (Loro CRDT, WASM Component Plugins, Farmhand Daemon)
- Next milestone: v0.1.0 "Sovereign Foundations" — First official public release of contract primitives
- Registry maturity: Tracking ready-to-publish packages in Package Registry
- Methodology: SDD → BDD → TDD → DDD
Categorized entry points for users, developers, and auditors.
- Architecture — Core design principles and Evolutionary Roadmap.
- Knowledge Map — The "Architecture of Truth" (Master Index).
- ADRs — Architectural Decision Records.
- Sovereign Workflow — The SDD→BDD→TDD→DDD process.
- DevOps & Setup — Environment, CI, and Reusable Workflows.
- Package Registry — List of all 26+ packages and their publishing maturity.
- PR Quality Governance — Quality gates and changeset policy.
- Security Policy — Disclosure and operational status.
- Agent Rules — Rules of engagement for AI collaborators.
- Main Roadmap — v0.1.0 through v1.0.0 milestones.
- Research Archive — Historical technical feasibility studies.
npm install
# Development
npm run dev # Watch mode for all apps
npm run build # Build all packages
npm test # Run tests
# Contribution workflow
npm run changeset # Create version changelog entrySee CONTRIBUTING.md for development guidelines.
- How to contribute: CONTRIBUTING.md
- PR quality policy: docs/PR_QUALITY_GOVERNANCE.md
- Security policy & disclosure: SECURITY.md
- Security operational status (audit/dependencies): docs/DEVOPS.md
- License: AGPL-3.0