Skip to content

Commit 4232477

Browse files
authored
Merge pull request #4 from SQLoot/public/preparation
Public/preparation
2 parents 4af1c00 + b5f8cd2 commit 4232477

2 files changed

Lines changed: 266 additions & 8 deletions

File tree

branding/sqloot-banner.svg

Lines changed: 189 additions & 0 deletions
Loading

profile/README.md

Lines changed: 77 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,89 @@
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%)
267

3-
Open-source infrastructure for intelligent data management.
68+
## 🎯 Next 4 Weeks
469

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.
675

7-
## Contributing
76+
## 🤝 Contributing
877

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.
1079

11-
## Security
80+
## 🔐 Security
1281

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).
1483

1584
---
1685

1786
<div align="center">
1887
<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>
2089
</div>

0 commit comments

Comments
 (0)