|
1 | | -# SQLoot |
| 1 | +<div align="center"> |
| 2 | + <img src="../branding/sqloot-banner.svg" alt="SQLoot banner" width="900" /> |
| 3 | +</div> |
| 4 | + |
| 5 | +<p align="center"> |
| 6 | + <strong>Local-First | Lab | E2EE | Infra | Benchmarks | Tools | CLI | Adapters | CRDT Sync | Relays</strong><br /> |
| 7 | + Public rollout is in progress (updated March 1, 2026). |
| 8 | +</p> |
| 9 | + |
| 10 | +<p align="center"> |
| 11 | + <img src="https://img.shields.io/badge/Public_rollout-WIP-f59e0b?style=flat-square" alt="Public rollout WIP" /> |
| 12 | + <img src="https://img.shields.io/badge/Built_on-Evolu-1f6feb?style=flat-square" alt="Foundation Evolu" /> |
| 13 | + <img src="https://img.shields.io/badge/Compatibility-SQLite-0ea5e9?style=flat-square" alt="SQLite compatibility" /> |
| 14 | + <img src="https://img.shields.io/badge/Bun-v1.3.10-111827?style=flat-square&logo=bun&logoColor=white" alt="Bun-first runtime" /> |
| 15 | +</p> |
| 16 | + |
| 17 | +## ⚡ Why SQLoot |
| 18 | + |
| 19 | +- 🌍 Grow the local-first community and make the ecosystem easier to discover and adopt. |
| 20 | +- 🛠️ Build practical tools and a robust CLI for developers and operators. |
| 21 | +- ⚡ Push performance in critical paths with Zig/Rust and systems-level optimizations. |
| 22 | +- 🧩 Keep Evolu compatibility while delivering upgrades and upstream-ready improvements. |
| 23 | +- 🧪 Run experiments, publish benchmarks, and propose new local-first specs where needed. |
| 24 | +- 🤖 Advance local-first collaboration patterns for AI agents. |
| 25 | + |
| 26 | +## 🤝 Foundation: Evolu |
| 27 | + |
| 28 | +SQLoot currently runs on top of an Evolu-based baseline. Our immediate strategy is to preserve upstream compatibility, ship measurable improvements in our fork, and upstream changes where applicable. |
| 29 | + |
| 30 | +- Upstream project: [evoluhq/evolu](https://github.com/evoluhq/evolu) |
| 31 | +- Upstream docs: [evolu.dev](https://www.evolu.dev) |
| 32 | +- SQLoot baseline fork: [SQLoot/evolu-plan-b](https://github.com/SQLoot/evolu-plan-b) |
| 33 | + |
| 34 | +Credit where it belongs: huge respect to [evoluhq](https://github.com/evoluhq) and [@steida](https://github.com/steida) for creating Evolu and moving the local-first ecosystem forward. |
| 35 | + |
| 36 | +## 🧱 What SQLoot Is Building |
| 37 | + |
| 38 | +| Track | Role | Current State | |
| 39 | +|---|---|---| |
| 40 | +| `evolu-plan-b` | Evolu-compatible Bun + Biome baseline | Public rollout | |
| 41 | +| `core` | SQLoot-native runtime foundations (Rust/Zig) | Planning | |
| 42 | +| `bench-suite` | Reproducible benchmark harness | WIP | |
| 43 | +| `relays` | Evolu-compatible relay implementations (Bun+Elysia/Rust/BEAM) | WIP | |
| 44 | +| `lootbox` | CLI umbrella, TUI, tools (Rust) | WIP | |
| 45 | +| `blind-cloud` | Encrypted cloud transport experiments (vault/relay/repacker) | Research | |
| 46 | +| `local-first` | Community forum, blog, wiki, guides | TBD | |
| 47 | +| `loot-cms` | File-based CMS, editor, sync storage | Research | |
| 48 | +| `loot-ops` | Org-wide platform glue for repos (Nix/IaC/CI) | Private | |
| 49 | +| `website` | Landing page, docs, bench measurements, stats | WIP | |
| 50 | +| `knowledge` | Obsidian KB, planning, issues, research | Internal | |
| 51 | + |
| 52 | +Public docs and public APIs are opening in phases as each track stabilizes. |
| 53 | + |
| 54 | +## 🗺️ 2026 Roadmap (WIP) |
| 55 | + |
| 56 | +### Milestone Progress (as of March 1, 2026) |
| 57 | + |
| 58 | +- [x] 📦 Public track for `evolu-plan-b` prepared (100%) |
| 59 | +- [x] 🧩 Evolu-based Bun-first baseline established (95%) |
| 60 | +- [ ] 🔌 Priority integrations (TanStack Start, Tauri, Astro) (75%) |
| 61 | +- [ ] 🧪 Benchmark harness foundation in `bench-suite` (45%) |
| 62 | +- [ ] 📊 Regression evidence gates (p50/p95/throughput/memory) (40%) |
| 63 | +- [ ] 🌐 Relay and transport hardening (`relays`, `blind-cloud`) (30%) |
| 64 | +- [ ] 🧱 SQLoot core bootstrap (`core`) (20%) |
| 65 | +- [ ] 🛠️ `lootbox` CLI baseline (scope, commands, packaging) (25%) |
| 66 | +- [ ] 📚 Public docs and evidence surfaces (`website`, `local-first`) (35%) |
2 | 67 |
|
3 | | -Open-source infrastructure for intelligent data management. |
| 68 | +## 🎯 Next 4 Weeks |
4 | 69 |
|
5 | | -> 🚧 **Coming Soon** - Repositories are currently private during development. |
| 70 | +1. Lock `evolu-plan-b` public baseline: keep CI green, tighten docs, and close rollout gaps. |
| 71 | +2. Ship `bench-suite` baseline lanes with reproducible report schema and first regression thresholds. |
| 72 | +3. Stabilize integration lanes for TanStack Start, Tauri, and Astro with actionable smoke outputs. |
| 73 | +4. Define and run relay hardening matrix for reconnect/load/failure handling in `relays`. |
| 74 | +5. Ship `lootbox` CLI v0 scope and first operator commands for workspace/bootstrap + benchmark flows. |
6 | 75 |
|
7 | | -## Contributing |
| 76 | +## 🤝 Contributing |
8 | 77 |
|
9 | | -We welcome contributions! See [CONTRIBUTING](https://github.com/SQLoot/.github/blob/main/CONTRIBUTING.md) for guidelines. |
| 78 | +Contributions are welcome. See [CONTRIBUTING](https://github.com/SQLoot/.github/blob/main/CONTRIBUTING.md) for workflow and quality standards. |
10 | 79 |
|
11 | | -## Security |
| 80 | +## 🔐 Security |
12 | 81 |
|
13 | | -Found a vulnerability? See [SECURITY](https://github.com/SQLoot/.github/blob/main/SECURITY.md) for responsible disclosure. |
| 82 | +For responsible disclosure, see [SECURITY](https://github.com/SQLoot/.github/blob/main/SECURITY.md). |
14 | 83 |
|
15 | 84 | --- |
16 | 85 |
|
17 | 86 | <div align="center"> |
18 | 87 | <a href="https://github.com/enterprises/ownCTRL"><img src="https://img.shields.io/badge/©️_2026-ownCTRL™-333?style=flat&labelColor=ddd" alt="© 2026 ownCTRL™"/></a> |
19 | | - <a href="https://github.com/ownctrl"><img src="https://img.shields.io/badge/⚙️_Maintained_with_🩶_by-%40ownctrl-333?style=flat&labelColor=ddd" alt="Maintained by @ownctrl"/></a> |
| 88 | + <a href="https://github.com/miccy"><img src="https://img.shields.io/badge/⚙️_Maintained_with_🩶_by-%40miccy-333?style=flat&labelColor=ddd" alt="Maintained by @miccy"/></a> |
20 | 89 | </div> |
0 commit comments