# thunderbolt | Thunderbird | Knowledge Base | Instagit

AI You Control: Choose your models. Own your data. Eliminate vendor lock-in.

GitHub Stars: 1.8k

Repository: https://github.com/thunderbird/thunderbolt

---

## Articles

### [How Thunderbolt Handles Account Deletion and Device Revocation Requests](/thunderbird/thunderbolt/how-does-thunderbolt-handle-account-deletion-and-device-revocation-requests)

Learn how Thunderbolt handles account deletion and device revocation. Discover the two-stage reset flow and HTTP status codes that ensure a clean signed-out state on the frontend.

- Tags: how-to-guide
- Published: 2026-04-19

### [How Claude Code Skills and Slash Commands Work in Thunderbolt: A Complete Guide](/thunderbird/thunderbolt/how-do-claude-code-skills-and-slash-commands-function-within-thunderbolt)

Learn how Claude Code skills and slash commands function in Thunderbolt. Discover how Markdown definitions in .thunderbot enable CLI execution of Makefile targets for streamlined workflows.

- Tags: how-to-guide
- Published: 2026-04-19

### [Thunderbolt Release Process: How to Publish New Versions Automatically](/thunderbird/thunderbolt/what-is-the-release-process-for-publishing-new-versions-of-thunderbolt)

Automate Thunderbolt releases with GitHub Actions. Our single workflow trigger updates versions, creates signed tags, builds binaries, and publishes to GitHub, TestFlight, and Google Play.

- Tags: how-to-guide
- Published: 2026-04-19

### [How the Vite Build Configuration Works for Production in Thunderbolt](/thunderbird/thunderbolt/how-does-the-vite-build-configuration-work-for-production-in-thunderbolt)

Explore the Vite build configuration for Thunderbolt production. Discover how it optimizes assets, externalizes modules, and enables features using a single vite.config.ts file.

- Tags: internals
- Published: 2026-04-19

### [How to Add New API Endpoints to the Thunderbolt Backend: A Complete Guide](/thunderbird/thunderbolt/how-do-i-add-new-api-endpoints-to-the-thunderbolt-backend)

Learn how to add new API endpoints to the Thunderbolt backend. This guide details creating Elysia route-group functions and mounting them in the createApp function.

- Tags: how-to-guide
- Published: 2026-04-19

### [How Thunderbolt Implements a Custom SharedWorker for PowerSync Sync Pipeline](/thunderbird/thunderbolt/what-are-the-implementation-details-of-the-custom-sharedworker-in-thunderbolt)

Discover how Thunderbolt uses a custom SharedWorker with encryption middleware for secure, multi-tab data synchronization via PowerSync and SQLite.

- Tags: internals
- Published: 2026-04-19

### [How to Set Up PostgreSQL with Drizzle ORM in Thunderbolt: Complete Backend Database Guide](/thunderbird/thunderbolt/how-is-the-backend-postgresql-database-set-up-with-drizzle-orm-in-thunderbolt)

Learn how to set up a PostgreSQL backend with Drizzle ORM in Thunderbolt. Explore driver-agnostic clients, schema definitions, and automatic migrations for efficient database management.

- Tags: how-to-guide
- Published: 2026-04-19

### [Device Approval Flow for End-to-End Encryption in Thunderbolt: Complete Technical Guide](/thunderbird/thunderbolt/what-is-the-device-approval-flow-for-end-to-end-encryption-in-thunderbolt)

Discover the device approval flow for end-to-end encryption in Thunderbolt. Learn how trusted devices access the Content Key using ECDH-ML-KEM and canary proof.

- Tags: how-to-guide
- Published: 2026-04-19

### [How to Integrate with OAuth Providers like Google and Microsoft in Thunderbolt](/thunderbird/thunderbolt/how-do-i-integrate-with-oauth-providers-like-google-and-microsoft-in-thunderbolt)

Integrate Google and Microsoft OAuth in Thunderbolt. Leverage its provider-agnostic layer, core engine, and React hook for seamless authentication and automated PKCE, state, and redirects.

- Tags: how-to-guide
- Published: 2026-04-19

### [Testing Frameworks in Thunderbolt: A Complete Guide to Unit, Component, and E2E Testing](/thunderbird/thunderbolt/what-testing-frameworks-are-used-in-thunderbolt-and-how-do-developers-write-tests)

Explore Thunderbolt's testing frameworks: Bun for unit/integration, React Testing Library for component, and Playwright for E2E. Learn how developers write tests efficiently.

- Tags: how-to-guide
- Published: 2026-04-19

### [How Thunderbolt Handles Responsive Sizing for Mobile and Desktop Devices](/thunderbird/thunderbolt/how-does-thunderbolt-handle-responsive-sizing-across-different-devices-like-mobile-and-desktop)

Discover how Thunderbolt delivers responsive sizing for mobile and desktop. Learn about its hybrid approach using Tailwind CSS and custom variables for optimized design across all devices.

- Tags: how-to-guide
- Published: 2026-04-19

### [How to Configure Custom CORS Headers for Thunderbolt](/thunderbird/thunderbolt/how-can-i-configure-custom-cors-headers-for-thunderbolt)

Learn how to configure custom CORS headers for Thunderbolt. Set CORS_ALLOW_HEADERS environment variable or modify settings.ts in thunderbird/thunderbolt for easy header management.

- Tags: how-to-guide
- Published: 2026-04-19

### [React Frontend State Management Architecture in Thunderbolt: Zustand, Context, and React Query](/thunderbird/thunderbolt/describe-the-react-frontend-state-management-architecture-in-thunderbolt)

Explore Thunderbolt's React state management: Zustand for global stores, Context for cross-cutting concerns, and React Query with PowerSync for real-time data. Optimize your frontend.

- Tags: architecture
- Published: 2026-04-19

### [Thunderbolt Tauri Desktop Application Architecture: A Deep Dive into the Rust Backend](/thunderbird/thunderbolt/what-is-the-architecture-of-the-tauri-desktop-application-in-thunderbolt)

Explore the Tauri desktop application architecture of Thunderbolt. Discover how the Rust backend in src-tauri manages native capabilities with a centralized app builder pattern.

- Tags: architecture
- Published: 2026-04-19

### [How to Add a New Table That Needs to Be Synced with PowerSync in Thunderbolt](/thunderbird/thunderbolt/how-do-i-add-a-new-table-that-needs-to-be-synced-with-powersync)

Learn how to add a new PowerSync synced table in Thunderbolt. Define schema, mirror PostgreSQL, register tables, expose to driver, update rules, and create migrations.

- Tags: how-to-guide
- Published: 2026-04-19

### [PowerSync Sync Middleware in Thunderbolt: Architecture and Extension Guide](/thunderbird/thunderbolt/what-is-the-powersync-sync-middleware-and-how-can-it-be-extended)

Explore the PowerSync sync middleware in Thunderbolt. Learn how this transformation layer converts database changes into actions and discover how to extend its functionality via custom transformer classes.

- Tags: architecture
- Published: 2026-04-19

### [Inference Proxy Rate Limiting and Routing in Thunderbolt: Responsibilities and Implementation](/thunderbird/thunderbolt/what-are-the-responsibilities-of-the-inference-proxy-regarding-rate-limiting-and-routing)

Learn how Thunderbolt's inference proxy manages rate limiting and routing. Discover its role in mapping models to AI providers and enforcing per-user request limits for optimal performance.

- Tags: deep-dive
- Published: 2026-04-19

### [How to Deploy Thunderbolt Using Docker Compose: Complete Setup Guide](/thunderbird/thunderbolt/how-do-i-deploy-thunderbolt-using-docker-compose)

Deploy Thunderbolt easily using Docker Compose. This guide details the multi-container setup orchestrated by docker-compose up --build for a seamless deployment experience.

- Tags: how-to-guide
- Published: 2026-04-19

### [How Thunderbolt's Backend Authentication System Works with Better Auth](/thunderbird/thunderbolt/how-does-the-backend-authentication-system-work-with-better-auth-in-thunderbolt)

Explore Thunderbolt's password-less backend authentication using Better Auth. Learn how OTP sign-in, PostgreSQL persistence, and waitlist hooks work together for secure access.

- Tags: internals
- Published: 2026-04-19

### [How to Set Up a Local Development Environment for Thunderbolt: A Complete Guide](/thunderbird/thunderbolt/how-can-i-set-up-a-local-development-environment-for-thunderbolt)

Set up a local development environment for Thunderbolt fast. Follow our guide to install Bun, Rust, Docker, and configure your .env files for a seamless setup.

- Tags: how-to-guide
- Published: 2026-04-19

### [Thunderbolt Model Providers: Supported Services and Custom Integration Guide](/thunderbird/thunderbolt/which-model-providers-are-supported-by-thunderbolt-and-how-can-custom-ones-be-added)

Explore Thunderbolt model providers including OpenAI Anthropic and custom OpenAI compatible endpoints. Learn how to integrate your own custom providers easily.

- Tags: how-to-guide
- Published: 2026-04-19

### [How Multi-Device Synchronization Works in Thunderbolt: PowerSync Architecture Explained](/thunderbird/thunderbolt/how-does-multi-device-synchronization-work-in-thunderbolt)

Understand Thunderbolt multi-device synchronization with PowerSync. Explore offline-first sync, client-side encryption, and real-time replication for consistent data across all your devices.

- Tags: architecture
- Published: 2026-04-19

### [Thunderbolt E2E Encryption Key Hierarchy: How Thunderbird Secures Your Sync Data](/thunderbird/thunderbolt/what-is-the-key-hierarchy-for-thunderbolts-e2e-encryption-implementation)

Explore the Thunderbolt E2E encryption key hierarchy. Learn how a single AES-256-GCM content key secures your sync data with unique hybrid envelope protection.

- Tags: internals
- Published: 2026-04-19

### [How Thunderbolt's Offline-First Architecture Uses SQLite and PowerSync](/thunderbird/thunderbolt/how-does-thunderbolts-offline-first-architecture-utilize-sqlite-and-powersync)

Discover how Thunderbolt's offline-first architecture uses SQLite for local data and PowerSync to replicate changes with a cloud PostgreSQL database. Learn about seamless data sync.

- Tags: architecture
- Published: 2026-04-19