Frequently asked questions
The questions Bridge users ask most often, with current canonical answers. Grouped by topic.
About the product
What is Bridge?
Bridge is a mobile-first notes-and-thinking workspace. You capture raw, scattered software ideas in the app; Bridge classifies them, finds semantic relationships between them, and generates implementation-ready specs — schema, API contract, component tree, data flow, constraints, acceptance criteria, and a plan document — that any coding agent can implement against. See What Bridge is for the longer overview.
What does "BYOAPI" mean and why?
BYOAPI means bring your own API key. Bridge does not provide LLM inference. You supply your own API key — Anthropic, OpenAI, or Google Gemini — and your AI costs are charged directly to your provider account by your provider. Bridge orchestrates the calls and charges you a flat subscription for that orchestration layer only.
This keeps Bridge's pricing predictable: you pay for what you use at provider cost, with no markup baked in. It also lets you choose your own models and control your own data relationship with the AI provider.
How much will I actually spend on AI costs?
It depends on your usage and which models you point Bridge at. A moderate usage profile — 5 notes per day, 5 Build Plans per month, 10 Chat sessions per month, daily clustering — costs roughly:
- All Haiku 4.5: ~$4/month
- Suggested defaults (Haiku for background, Sonnet 4.6 for Build Plan and Chat): ~$6/month
- All Sonnet 4.6: ~$12/month
- All Opus 4.8: ~$20/month
Bridge will show a per-feature usage breakdown in Settings → Usage so you always know where costs are coming from. The Free tier runs no AI by default — your only cost is your time. If you add your own key, you can also open one chat, which uses your key like any other AI feature.
What does the LTD ("Lifetime") tier actually mean?
"Lifetime" means the operational lifetime of Bridge, not the lifetime of the universe. Bridge commits to operating the service for a minimum of three years from your LTD purchase date, to providing 90 days written notice before any discontinuation, and to making your data available for export during that notice period. LTD purchases are final sale. This follows the SaaS industry standard for lifetime deals.
Will prices change?
Launch prices are locked. Bridge may raise prices for new signups around six months post-launch, but existing customers — including anyone who signs up during the pre-launch window — are grandfathered at their original rate. The 15% pre-launch discount on first-year yearly plans is a one-time benefit; year 2 onward, you renew at the standard yearly rate.
Where can I buy each tier?
| Channel | All tiers except LTD | LTD | |---|---|---| | Web (bridgedev.io) | ✓ via Stripe | ✓ via Stripe | | iOS App Store | ✓ via IAP | — (Apple does not allow lifetime subscriptions) | | Google Play | ✓ via Play Billing | — (same reason) |
Buy on one platform, sign in on another, your tier appears instantly. One entitlement everywhere.
When does Bridge launch?
Public launch is early September 2026. Pre-order customers get access ahead of public launch and get first access to leave feedback before general availability.
What platforms does Bridge support?
iOS and Android at launch. The bridgedev.io web surface is currently marketing only — the workspace itself is mobile.
How is my data handled?
Notes are stored on your device and in your own private, isolated space on Bridge's infrastructure to enable the service. When you run AI features — expansion, clustering, chat, Build Plan — note content is sent to your chosen AI provider per their API terms. Bridge does not sell user data. API keys are held in encrypted secret storage, separate from your notes. Full details at /legal/privacy.
About notes and constellations
Why can't I edit a note after I capture it?
The raw text of a captured note is immutable in the current version. The reason is cascade safety: if you edited a note, everything downstream that depended on it — its expansion, the constellation it belonged to, any chat that referenced it, any Build Plan that included it — would need to re-run or get re-validated. We're researching cascade re-processing and it will likely ship post-launch. For now: the on-capture scan and expansion can re-run, but the source text stays as you typed it.
How long until my note shows up in the graph?
About thirty seconds for the initial scan to extract URLs, hashtags, and code blocks, and to draw connections to related notes. On Discover tier and above, the general expansion usually finishes within one to two minutes after that. Clustering runs in batches; expect new constellations to surface within five to ten minutes of adding notes that warrant a new cluster.
If you want to force the graph to catch up immediately, pull down at the top of the Notes tab — see The graph view.
What if I disagree with the auto-classification?
Tap the classification chip on the note detail page. You can override Expandable → Reference or Reference → Expandable. Bridge doesn't push back; your override is the source of truth from that point.
My note shows as an orphan instead of in a constellation — why?
Constellations form once Bridge sees three or more semantically-related notes. If your note is the first or second of a theme, it sits as an orphan until enough siblings show up. Keep capturing related notes; clustering will connect them. If you're certain the note should be in an existing constellation, you can manually assert an edge via long-press → Connect to... (see The graph view).
About Build Plan output
Can I regenerate a Build Plan?
Yes. Start a venture from the same note again. The new run uses your current context — latest notes, latest expansions, latest user-behavior memory. The old version stays in the Plan tab archive so you can pick which version to download or share. Build Plan regeneration is unlimited on Build, Refine, and Refine LTD tiers.
Can I edit the plan files directly outside Bridge?
Yes. The files are markdown — you can open them in any editor and change anything. Once you've edited outside Bridge, the in-app Plan tab will show the stale version unless you regenerate. The Refine-tier in-app diff-approval flow only works on plan files Bridge still has the canonical version of (see Refining a plan). For most users: edit in Bridge if you're going to keep iterating; edit externally only once the plan is feeding production code and you want to keep changes in your repo's history.
What if my coding agent doesn't read AGENTS.md automatically?
Most modern coding agents read a project context file at the project root by default — AGENTS.md is the emerging cross-tool standard for that file. If your agent doesn't pick it up automatically, point it at the file explicitly in your first prompt: "Read AGENTS.md at the project root and follow its working agreement." The content is portable — same reading order, same instructions, no tool-specific magic.
Still have a question?
Press ⌘K (or Ctrl-K) to search the docs. If the answer isn't here, reach out — Bridge is small enough that we read every email. Contact details on the About page.