feat(sync): wire up cf-core sync module for cross-device localStorage #58

New issue

Open

opened 2026-06-05 12:53:52 -07:00 by pyr0ball · 0 comments

pyr0ball commented

2026-06-05 12:53:52 -07:00

Owner

Context

circuitforge_core.sync (cf-core #56 + #57) ships a shared opt-in localStorage sync module. Snipe users on multiple devices lose saved searches and dismissed listings on browser clear.

What to wire up

Install dep: pip install -e ../circuitforge-core[sync]
In the FastAPI app, add:

from circuitforge_core.sync import make_sync_router, SyncConfig

sync_router = make_sync_router(
    product="snipe",
    get_session=_sessions.dependency(),
    require_paid=_sessions.require_tier("paid"),
    config=SyncConfig.from_env("snipe"),
)
app.include_router(sync_router, prefix="/sync", tags=["sync"])

Add SYNC_DB_PATH / CLOUD_DATA_ROOT to .env.example
Add frontend sync toggle UI — one toggle per data class:
- snipe:saved_searches
- snipe:dismissed
Wire localStorage writes to call POST /sync/push after save (Paid+ only)
On app load (Paid+), call GET /sync/pull and merge

Notes

Prefs default to disabled — no pre-checked boxes, consent is per data class
DELETE /sync/all must be accessible from account settings (any tier)

References

cf-core sync module: circuitforge_core/sync/
cf-core #56 (storage), #57 (consent layer)

## Context `circuitforge_core.sync` (cf-core #56 + #57) ships a shared opt-in localStorage sync module. Snipe users on multiple devices lose saved searches and dismissed listings on browser clear. ## What to wire up 1. Install dep: `pip install -e ../circuitforge-core[sync]` 2. In the FastAPI app, add: ```python from circuitforge_core.sync import make_sync_router, SyncConfig sync_router = make_sync_router( product="snipe", get_session=_sessions.dependency(), require_paid=_sessions.require_tier("paid"), config=SyncConfig.from_env("snipe"), ) app.include_router(sync_router, prefix="/sync", tags=["sync"]) ``` 3. Add `SYNC_DB_PATH` / `CLOUD_DATA_ROOT` to `.env.example` 4. Add frontend sync toggle UI — one toggle per data class: - `snipe:saved_searches` - `snipe:dismissed` 5. Wire localStorage writes to call `POST /sync/push` after save (Paid+ only) 6. On app load (Paid+), call `GET /sync/pull` and merge ## Notes - Prefs default to disabled — no pre-checked boxes, consent is per data class - `DELETE /sync/all` must be accessible from account settings (any tier) ## References - cf-core sync module: `circuitforge_core/sync/` - cf-core #56 (storage), #57 (consent layer)