From f7c000a573743fb8c8e99b7f15996d8278822924 Mon Sep 17 00:00:00 2001 From: Miccy Date: Sun, 1 Mar 2026 17:24:31 +0100 Subject: [PATCH 1/3] feat: add SVG project banner and update GitHub profile README with new branding. --- branding/sqloot-banner.svg | 189 +++++++++++++++++++++++++++++++++++++ profile/README.md | 87 +++++++++++++++-- 2 files changed, 268 insertions(+), 8 deletions(-) create mode 100644 branding/sqloot-banner.svg diff --git a/branding/sqloot-banner.svg b/branding/sqloot-banner.svg new file mode 100644 index 0000000..13149fa --- /dev/null +++ b/branding/sqloot-banner.svg @@ -0,0 +1,189 @@ + diff --git a/profile/README.md b/profile/README.md index 2c24022..9f1f130 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,20 +1,91 @@ -# SQLoot +
+ SQLoot banner +
+ +

+ Local-First | Lab | E2EE | Infra | Benchmarks | Tools | CLI | Adapters | CRDT Sync | Relays
+ Public rollout is in progress (updated March 1, 2026). +

+ +

+ Public rollout WIP + Foundation Evolu + SQLite compatibility + Bun-first runtime +

+ +## ⚡ Why SQLoot + +- 🔒 Sovereign-by-design local-first data infrastructure. +- ⚙️ Bun-first and SQLite-compatible runtime direction. +- 📊 Evidence-driven engineering via reproducible benchmarks. +- 🧩 Evolu-compatible now. + +## 🤝 Foundation: Evolu + +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. + +- Upstream project: [evoluhq/evolu](https://github.com/evoluhq/evolu) +- Upstream docs: [evolu.dev](https://www.evolu.dev) +- SQLoot baseline fork: [SQLoot/evolu-plan-b](https://github.com/SQLoot/evolu-plan-b) -Open-source infrastructure for intelligent data management. +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. -> 🚧 **Coming Soon** - Repositories are currently private during development. +## 🧱 What SQLoot Is Building -## Contributing +| Track | Role | Current State | +|---|---|---| +| `evolu-plan-b` | Evolu-compatible Bun + Biome baseline | Public rollout | +| `core` | SQLoot-native runtime foundations (Rust, Zig) | Planning | +| `bench-suite` | Reproducible benchmark harness | WIP | +| `relays` | Evolu-compatible relay implementations (TS, Rust, BEAM, Elysia) | WIP | +| `lootbox` | CLI umbrella & tools (Rust) | WIP | +| `blind-cloud` | Encrypted cloud transport experiments (vault/relay/repacker) | Research | +| `local-first` | Community forum, blog, wiki, guides | TBD | +| `loot-cms` | File-based CMS, editor, sync storage | Research | +| `loot-ops` | Org-wide Nix/IaC/CI platform glue for repos | Private | +| `website` | Landing page, docs, bench measurements, stats | WIP | +| `knowledge` | Obsidian KB, planning, issues, research | Internal | -We welcome contributions! See [CONTRIBUTING](https://github.com/SQLoot/.github/blob/main/CONTRIBUTING.md) for guidelines. +Public docs and public APIs are opening in phases as each track stabilizes. -## Security +## 🗺️ 2026 Roadmap (WIP Checklist) -Found a vulnerability? See [SECURITY](https://github.com/SQLoot/.github/blob/main/SECURITY.md) for responsible disclosure. +### Milestone - Track Progress + +- [x] 🧩 Evolu-based Bun-first baseline established +- [x] 📦 Public track for `evolu-plan-b` prepared +- [ ] 🧪 Benchmark harness foundation running in `bench-suite` (~45%) +- [ ] 📈 Stable regression gates with p50/p95/throughput/memory evidence +- [ ] 🏗️ SQLoot core bootstrap beyond skeleton phase +- [ ] 🔐 Relay and transport hardening to public-ready operations +- [ ] 🔌 Priority integrations (TanStack Start, Tauri, Astro) (~70%) +- [ ] 🧩 Evolu compatibility and stabilization (~90%) +- [ ] 📊 Benchmark reliability and CI evidence (~45%) +- [ ] 🧱 SQLoot core bootstrap (~20%) +- [ ] 🌐 Relay and transport hardening (~30%) +- [ ] 🔌 Priority integrations (~20%) + +## 🎯 Next 4 Weeks + +1. Ship stable relay-sync benchmark lane with report schema v1. +2. Deliver real finance reference workload for both demo and benchmark use. +3. Finalize benchmark integration SDK/API for external app and framework lanes. +4. Close bench reliability gaps (driver parity, scenario coverage, regression policy). +5. Publish clearer public docs and benchmark evidence surfaces. + +## 🤝 Contributing + +Contributions are welcome. See [CONTRIBUTING](https://github.com/SQLoot/.github/blob/main/CONTRIBUTING.md) for workflow and quality standards. + +## 🔐 Security + +For responsible disclosure, see [SECURITY](https://github.com/SQLoot/.github/blob/main/SECURITY.md). ---
© 2026 ownCTRL™ - Maintained by @ownctrl + Maintained by @miccy
+ From 43a414cbdac8caee8ab42a76cde98f4164979351 Mon Sep 17 00:00:00 2001 From: Miccy Date: Sun, 1 Mar 2026 17:38:37 +0100 Subject: [PATCH 2/3] docs: Update project vision, track details, roadmap, and immediate priorities in README. --- profile/README.md | 54 +++++++++++++++++++++++------------------------ 1 file changed, 26 insertions(+), 28 deletions(-) diff --git a/profile/README.md b/profile/README.md index 9f1f130..8181af8 100644 --- a/profile/README.md +++ b/profile/README.md @@ -16,10 +16,12 @@ ## ⚡ Why SQLoot -- 🔒 Sovereign-by-design local-first data infrastructure. -- ⚙️ Bun-first and SQLite-compatible runtime direction. -- 📊 Evidence-driven engineering via reproducible benchmarks. -- 🧩 Evolu-compatible now. +- 🌍 Grow the local-first community and make the ecosystem easier to discover and adopt. +- 🛠️ Build practical tools and a robust CLI for developers and operators. +- ⚡ Push performance in critical paths with Zig/Rust and systems-level optimizations. +- 🧩 Keep Evolu compatibility while delivering upgrades and upstream-ready improvements. +- 🧪 Run experiments, publish benchmarks, and propose new local-first specs where needed. +- 🤖 Advance local-first collaboration patterns for AI agents. ## 🤝 Foundation: Evolu @@ -36,43 +38,40 @@ Credit where it belongs: huge respect to [evoluhq](https://github.com/evoluhq) a | Track | Role | Current State | |---|---|---| | `evolu-plan-b` | Evolu-compatible Bun + Biome baseline | Public rollout | -| `core` | SQLoot-native runtime foundations (Rust, Zig) | Planning | +| `core` | SQLoot-native runtime foundations (Rust/Zig) | Planning | | `bench-suite` | Reproducible benchmark harness | WIP | -| `relays` | Evolu-compatible relay implementations (TS, Rust, BEAM, Elysia) | WIP | -| `lootbox` | CLI umbrella & tools (Rust) | WIP | +| `relays` | Evolu-compatible relay implementations (Bun+Elysia/Rust/BEAM) | WIP | +| `lootbox` | CLI umbrella, TUI, tools (Rust) | WIP | | `blind-cloud` | Encrypted cloud transport experiments (vault/relay/repacker) | Research | | `local-first` | Community forum, blog, wiki, guides | TBD | | `loot-cms` | File-based CMS, editor, sync storage | Research | -| `loot-ops` | Org-wide Nix/IaC/CI platform glue for repos | Private | +| `loot-ops` | Org-wide platform glue for repos (Nix/IaC/CI) | Private | | `website` | Landing page, docs, bench measurements, stats | WIP | | `knowledge` | Obsidian KB, planning, issues, research | Internal | Public docs and public APIs are opening in phases as each track stabilizes. -## 🗺️ 2026 Roadmap (WIP Checklist) +## 🗺️ 2026 Roadmap (WIP) -### Milestone - Track Progress +### Milestone Progress (as of March 1, 2026) -- [x] 🧩 Evolu-based Bun-first baseline established -- [x] 📦 Public track for `evolu-plan-b` prepared -- [ ] 🧪 Benchmark harness foundation running in `bench-suite` (~45%) -- [ ] 📈 Stable regression gates with p50/p95/throughput/memory evidence -- [ ] 🏗️ SQLoot core bootstrap beyond skeleton phase -- [ ] 🔐 Relay and transport hardening to public-ready operations -- [ ] 🔌 Priority integrations (TanStack Start, Tauri, Astro) (~70%) -- [ ] 🧩 Evolu compatibility and stabilization (~90%) -- [ ] 📊 Benchmark reliability and CI evidence (~45%) -- [ ] 🧱 SQLoot core bootstrap (~20%) -- [ ] 🌐 Relay and transport hardening (~30%) -- [ ] 🔌 Priority integrations (~20%) +- [x] 📦 Public track for `evolu-plan-b` prepared (100%) +- [x] 🧩 Evolu-based Bun-first baseline established (95%) +- [ ] 🔌 Priority integrations (TanStack Start, Tauri, Astro) (75%) +- [ ] 🧪 Benchmark harness foundation in `bench-suite` (45%) +- [ ] 📊 Regression evidence gates (p50/p95/throughput/memory) (40%) +- [ ] 🌐 Relay and transport hardening (`relays`, `blind-cloud`) (30%) +- [ ] 🧱 SQLoot core bootstrap (`core`) (20%) +- [ ] 🛠️ `lootbox` CLI baseline (scope, commands, packaging) (25%) +- [ ] 📚 Public docs and evidence surfaces (`website`, `local-first`) (35%) ## 🎯 Next 4 Weeks -1. Ship stable relay-sync benchmark lane with report schema v1. -2. Deliver real finance reference workload for both demo and benchmark use. -3. Finalize benchmark integration SDK/API for external app and framework lanes. -4. Close bench reliability gaps (driver parity, scenario coverage, regression policy). -5. Publish clearer public docs and benchmark evidence surfaces. +1. Lock `evolu-plan-b` public baseline: keep CI green, tighten docs, and close rollout gaps. +2. Ship `bench-suite` baseline lanes with reproducible report schema and first regression thresholds. +3. Stabilize integration lanes for TanStack Start, Tauri, and Astro with actionable smoke outputs. +4. Define and run relay hardening matrix for reconnect/load/failure handling in `relays`. +5. Ship `lootbox` CLI v0 scope and first operator commands for workspace/bootstrap + benchmark flows. ## 🤝 Contributing @@ -88,4 +87,3 @@ For responsible disclosure, see [SECURITY](https://github.com/SQLoot/.github/blo © 2026 ownCTRL™ Maintained by @miccy - From b5f8cd2b063586d51e395db669c9dc2af6442081 Mon Sep 17 00:00:00 2001 From: Miccy Date: Sun, 1 Mar 2026 17:56:53 +0100 Subject: [PATCH 3/3] Update profile/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Miccy --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index 8181af8..2f6342c 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,5 +1,5 @@
- SQLoot banner + SQLoot banner