Skip to content

tronbrowser-prd.md

Latest commit

 

History

History
211 lines (171 loc) · 3.48 KB

tronbrowser-prd.md

File metadata and controls

211 lines (171 loc) · 3.48 KB

TronBrowser.dev - Engineering PRD (v2)

Vision

TronBrowser is an open-source, privacy-first, AI-native browser built on a Chromium fork.

Principles

  • No telemetry by default
  • No ads
  • No sponsored tabs
  • No affiliate injection
  • User-owned data
  • Chrome compatibility
  • Self-hostable services

Goals

  1. Desktop Chromium browser
  2. React Native mobile (Phase 2)
  3. Cloud agents
  4. Plugin ecosystem
  5. Multi-agent platform

Stack

  • pnpm workspaces
  • Node.js 24+
  • TypeScript
  • Chromium / Ungoogled Chromium
  • React Native
  • Hono/Fastify
  • Turso
  • Redis/BullMQ
  • Cloudflare R2
  • Docker
  • Railway

Monorepo

apps/

  • desktop
  • mobile
  • web
  • docs

packages/

  • ai-core
  • browser-core
  • workflow-engine
  • agent-runtime
  • model-providers
  • auth
  • sync
  • storage
  • sdk
  • plugins
  • payments
  • ui
  • shared

services/

  • api
  • worker
  • scheduler
  • sync-server

Desktop Requirements

Must preserve:

  • Chrome extensions
  • Profiles
  • Bookmarks
  • Downloads
  • History
  • PWAs
  • DevTools

Replace:

  • Branding
  • Telemetry
  • Sponsored integrations

AI

Providers (BYOK set mirrors crawlproof.com — 8 cloud + local):

  • Anthropic (ANTHROPIC_API_KEY)
  • OpenAI (OPENAI_API_KEY)
  • Google / Gemini (GEMINI_API_KEY)
  • DeepSeek (DEEPSEEK_API_KEY)
  • Perplexity (PERPLEXITY_API_KEY)
  • Hugging Face (HUGGINGFACE_API_KEY)
  • Kimi / Moonshot (MOONSHOT_API_KEY / KIMI_API_KEY)
  • Qwen / Alibaba (DASHSCOPE_API_KEY / QWEN_API_KEY)
  • Local (keyless): Ollama, LM Studio, vLLM

Keys:

  • BYOK (free / self-hosted): user's own keys from web app .env / their store
  • Cloud (paid): OUR keys in the DB (ai_provider_keys, scoped per app_id — multi-app)
  • resolveProviderKey prefers BYOK, falls back to cloud on paid plans

Execution:

  • Local
  • Cloud
  • Hybrid

Agent Runtime

Components:

  • Planner
  • Executor
  • Validator
  • Memory
  • Tool Registry
  • Workflow Runner

Workflow Engine

Node types:

  • Prompt
  • Browser
  • AI
  • HTTP
  • Conditional
  • Delay
  • Export

Plugin SDK

Lifecycle:

  • install
  • enable
  • disable
  • update
  • uninstall

Payments

CoinPay OAuth + x402.

Auth:

  • CoinPay OAuth (Authorization Code + PKCE)
  • Scopes: wallet:read, payments:x402
  • Self-hosted CoinPay overridable

x402 (HTTP 402 Payment Required):

  • Parse payment requirements from 402 responses
  • Pay from the user's CoinPay global wallet addresses (match network + asset)
  • Custodial keys (never leave CoinPay)
  • Per-request maxAmount guard; budgets/ledger via agent runtime

Package: packages/payments (x402 + CoinPay wallet + PaymentProcessor)

Storage

SQLite/libSQL, self-hostable.

  • Default: managed cloud DB (Turso) — managed backups + replication
  • Bring your own: local SQLite file, local libSQL replica, or your own libSQL server (self-hosted, user-owned, user-managed backups)
  • Object storage: Cloudflare R2
  • Config via TRONBROWSER_DB_URL / TRONBROWSER_DB_AUTH_TOKEN / TRONBROWSER_DB_PATH

Sync

Objects:

  • bookmarks
  • prompts
  • workflows
  • settings
  • profiles

Mobile (Phase 2)

React Native:

  • Android
  • iOS

Features:

  • AI chat
  • Sync
  • Voice
  • Push notifications
  • Agent dashboard

CI/CD

GitHub Actions:

  • lint
  • typecheck
  • test
  • build
  • package
  • release

Claude Code Rules

  • Stub all packages first.
  • Define interfaces before implementations.
  • Keep shared logic in packages.
  • Desktop-specific code stays isolated.
  • Add README and tests to every package.
  • Use strict TypeScript.
  • Prefer composition.
  • Document architecture decisions.

Milestones

M0 Monorepo M1 Chromium fork M2 AI sidebar M3 Browser agents M4 Cloud services M5 Mobile M6 Plugins M7 Agent swarms