https://github.com/aretw0/refarm
Personal Operating System for Sovereign Data
https://github.com/aretw0/refarm
astro crdt decentralized identity interoperability local-first matrix monorepo nostr offline-first opfs plugin-runtime plugin-system privacy-by-design resilient-systems sovereign-tech sqlite turbo typescript webassembly
Last synced: 29 days ago
JSON representation
Personal Operating System for Sovereign Data
- Host: GitHub
- URL: https://github.com/aretw0/refarm
- Owner: aretw0
- License: agpl-3.0
- Created: 2026-03-04T04:09:57.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-15T01:52:18.000Z (30 days ago)
- Last Synced: 2026-05-15T03:37:59.406Z (30 days ago)
- Topics: astro, crdt, decentralized, identity, interoperability, local-first, matrix, monorepo, nostr, offline-first, opfs, plugin-runtime, plugin-system, privacy-by-design, resilient-systems, sovereign-tech, sqlite, turbo, typescript, webassembly
- Language: TypeScript
- Homepage:
- Size: 4.9 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
- Roadmap: roadmaps/MAIN.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
Refarm
Personal Operating System for Sovereign Data
[](https://refarm.dev)
[](https://www.patreon.com/cw/refarm88)
[](https://github.com/sponsors/aretw0)
[](LICENSE)
> **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.
---
## Why This Matters
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.
---
## The Sovereign Ecosystem
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.
---
## Status
🌱 **Maturing toward cohesion — creator as first user**
The core engine is built. The current focus is on becoming a real daily driver before any public release: consolidating the primitives into a cohesive system the creator uses for their own life and work. No v0.1.0 release until it earns that trust.
- **Current phase**: Phase 6 — Sync & Execution Stabilization (Loro CRDT, WASM Plugins, dual-runtime Tractor)
- **Pre-release gate**: creator daily-driver validation — Tractor + Homestead + stream contract working end-to-end
- **Registry maturity**: Tracking ready-to-publish packages in [Package Registry](packages/README.md) (44 packages)
- **Methodology**: [SDD → BDD → TDD → DDD](docs/WORKFLOW.md)
---
## 🗺 Sovereign Navigation Map
Categorized entry points for users, developers, and auditors.
### 🏛 Philosophy & Arch
- **[Architecture](docs/ARCHITECTURE.md)** — Core design principles and Evolutionary Roadmap.
- **[Knowledge Map](docs/INDEX.md)** — The "Architecture of Truth" (Master Index).
- **[ADRs](specs/ADRs/README.md)** — Architectural Decision Records.
### 🛠 Development & Ops
- **[Sovereign Workflow](docs/WORKFLOW.md)** — The SDD→BDD→TDD→DDD process.
- **[DevOps & Setup](docs/DEVOPS.md)** — Environment, CI, and Reusable Workflows.
- **[Package Registry](packages/README.md)** — List of all 44 packages and their publishing maturity.
### 🛡 Governance & Security
- **[PR Quality Governance](docs/PR_QUALITY_GOVERNANCE.md)** — Quality gates and changeset policy.
- **[Security Policy](SECURITY.md)** — Disclosure and operational status.
- **[Agent Rules](AGENTS.md)** — Rules of engagement for AI collaborators.
### 📊 Status & Roadmap
- **[Main Roadmap](roadmaps/MAIN.md)** — v0.1.0 through v1.0.0 milestones.
- **[Research Archive](docs/research/INDEX.md)** — Historical technical feasibility studies.
---
## Getting Started
```bash
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 entry
```
See [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines.
---
## Contributing & Security
- **How to contribute:** [CONTRIBUTING.md](CONTRIBUTING.md)
- **PR quality policy:** [docs/PR_QUALITY_GOVERNANCE.md](docs/PR_QUALITY_GOVERNANCE.md)
- **Security policy & disclosure:** [SECURITY.md](SECURITY.md)
- **Security operational status (audit/dependencies):** [docs/DEVOPS.md](docs/DEVOPS.md)
- **License:** [AGPL-3.0](LICENSE)
---
## Further Reading
- [Full Architecture Document](docs/ARCHITECTURE.md)
- [Development Workflow](docs/WORKFLOW.md)
- [Main Roadmap](roadmaps/MAIN.md)
- [Research Validations](docs/research/)