# Bloom

> Bloom is the opinionated application platform for Dart & Flutter. It unites an enterprise framework (Signals reactivity, Next.js-style filesystem routing, deterministic boot lifecycle, hierarchical DI, and TanStack-style data layer), Bloom Server (a 15-package Django-style backend ecosystem sharing the same core framework), Cloud OTA delivery powered by Shorebird, and 60+ unstyled UI primitives inspired by shadcn/ui.

## Core Overview & Entrypoints
- [Bloom Platform Overview](https://bloom-platform-ten.vercel.app/index.md): Complete architecture overview, feature breakdown, and quickstart commands.
- [BUILD — Framework Architecture](https://bloom-platform-ten.vercel.app/build.md): Deep dive into Signals state, routing, DI container, and native prebuild engine.
- [SHIP — Cloud & OTA Delivery](https://bloom-platform-ten.vercel.app/ship.md): Over-the-air code updates, bytecode diff patching, cloud release channels, and rollback guarantees.
- [BLOOM — UI Studio & Primitives](https://bloom-platform-ten.vercel.app/bloom.md): 60+ unstyled Flutter primitives, 8 design style presets, and pure Dart chart suite.
- [Bloom UI Components Catalog](https://bloom-platform-ten.vercel.app/ui.md): Index of all 34 form controls, feedback overlays, layout structures, and data displays.
- [Application Blocks Catalog](https://bloom-platform-ten.vercel.app/blocks.md): Pre-built dashboard, authentication, chat, and settings screen templates with complete Flutter code.
- [Themes & Design Tokens](https://bloom-platform-ten.vercel.app/themes.md): Token specifications, radius scales, animation curves, and 8 style presets.

## Getting Started & Tutorials
- [5-Minute Quickstart](https://bloom-platform-ten.vercel.app/docs/framework/quickstart.md): Build your first reactive Bloom application in 5 minutes with Signals, DI, and routes.
- [Installation Guide](https://bloom-platform-ten.vercel.app/docs/installation.md): Set up Bloom CLI and configure Flutter project extensions.
- [Project Anatomy & Structure](https://bloom-platform-ten.vercel.app/docs/getting-started/project-anatomy.md): Detailed explanation of Bloom project files, routes, controllers, and services.
- [bloom.yaml Schema Reference](https://bloom-platform-ten.vercel.app/docs/getting-started/bloom-yaml-reference.md): Complete configuration reference for declarative manifests.

## Runtime & Architecture
- [Boot Lifecycle & Initialization](https://bloom-platform-ten.vercel.app/docs/runtime/boot-lifecycle.md): Deterministic bootstrap sequence and async initialization stages.
- [Signals Reactivity & Controllers](https://bloom-platform-ten.vercel.app/docs/runtime/signals-and-controllers.md): Fine-grained reactive state management with Signals, Computed, Effects, and BloomController.
- [Filesystem Routing & Navigation](https://bloom-platform-ten.vercel.app/docs/runtime/filesystem-routing.md): Next.js-style file-based routing compiled into strongly-typed GoRouter tables.
- [Dependency Injection & Container](https://bloom-platform-ten.vercel.app/docs/runtime/dependency-injection.md): Hierarchical DI container with singleton, factory, and scoped bindings.
- [Config & Environment Variables](https://bloom-platform-ten.vercel.app/docs/runtime/config-and-env.md): Type-safe compile-time environment configuration.
- [Structured Logging & Diagnostics](https://bloom-platform-ten.vercel.app/docs/runtime/logging.md): Production logging system with DevTools integration.

## Data Layer & Caching
- [Data Layer Architecture](https://bloom-platform-ten.vercel.app/docs/framework/data.md): TanStack-inspired data management: queries, mutations, SWR cache, and offline queue.
- [Server Queries (BloomQuery)](https://bloom-platform-ten.vercel.app/docs/data/queries.md): Declarative async queries with automatic deduplication and background revalidation.
- [Mutations & Optimistic UI](https://bloom-platform-ten.vercel.app/docs/data/mutations.md): Asynchronous data writes with automatic rollback on failure.
- [Cache & Garbage Collection](https://bloom-platform-ten.vercel.app/docs/data/cache-and-garbage-collection.md): In-memory LRU cache and background cache eviction policies.
- [Resilient HTTP Client](https://bloom-platform-ten.vercel.app/docs/data/http-client.md): Interceptors, automatic retry policies, and JWT token injection.
- [Offline Queue & Sync](https://bloom-platform-ten.vercel.app/docs/data/offline-queue.md): Persistent mutation queue with network reconnect synchronization.
- [Storage Adapters](https://bloom-platform-ten.vercel.app/docs/data/storage-adapters.md): SQLite, Hive, and memory drivers for local persistence.
- [Authentication Flow](https://bloom-platform-ten.vercel.app/docs/data/authentication.md): Secure JWT storage, automatic token refreshing, and route guard integration.
- [Typed Repositories Pattern](https://bloom-platform-ten.vercel.app/docs/data/repositories.md): Clean Architecture repository patterns in Dart.

## Native & Prebuild Engine
- [Prebuild & Native Sync Engine](https://bloom-platform-ten.vercel.app/docs/native/prebuild-engine.md): Continuous Expo-style prebuild syncing iOS and Android native configurations.
- [Permissions Management](https://bloom-platform-ten.vercel.app/docs/native/permissions.md): Declarative iOS Info.plist and Android AndroidManifest.xml permissions.
- [Deep Links & Universal Links](https://bloom-platform-ten.vercel.app/docs/native/deep-links.md): App Links and Universal Links setup.
- [Flavors & Build Schemes](https://bloom-platform-ten.vercel.app/docs/native/flavors.md): Development, staging, and production build flavors.
- [Native Config Plugins](https://bloom-platform-ten.vercel.app/docs/native/plugins.md): Custom build-time CocoaPods and Gradle injection plugins.

## CLI Tooling Reference
- [Bloom CLI Master Overview](https://bloom-platform-ten.vercel.app/docs/cli.md): CLI architecture and workflow commands.
- [CLI Command Index](https://bloom-platform-ten.vercel.app/docs/cli/commands.md): Exhaustive command, flag, and option reference.
- [bloom create](https://bloom-platform-ten.vercel.app/docs/cli/create.md): Project scaffolding command.
- [bloom dev](https://bloom-platform-ten.vercel.app/docs/cli/dev.md): High-speed dev server with live watcher and QR launcher.
- [bloom generate](https://bloom-platform-ten.vercel.app/docs/cli/generate.md): Automated code generation without build_runner friction.
- [bloom prebuild](https://bloom-platform-ten.vercel.app/docs/cli/prebuild.md): Native project generator.
- [bloom deploy](https://bloom-platform-ten.vercel.app/docs/cli/deploy.md): Over-the-air code push and cloud release publisher.
- [bloom doctor](https://bloom-platform-ten.vercel.app/docs/cli/doctor.md): Dependency diagnostic and repair tool.

## Developer Experience & Tooling
- [Bloom Go Companion App](https://bloom-platform-ten.vercel.app/docs/dev-experience/bloom-go.md): Instant wireless testing sandbox on physical iOS and Android devices.
- [Local Dev Server](https://bloom-platform-ten.vercel.app/docs/dev-experience/dev-server.md): Live WebSocket orchestrator.
- [Flutter DevTools Extension](https://bloom-platform-ten.vercel.app/docs/dev-experience/devtools-extensions.md): Signals graph and Query inspector.
- [Cloud OTA Deployments](https://bloom-platform-ten.vercel.app/docs/dev-experience/ota-deployments.md): Over-the-air deployment pipeline.

## Cloud Platform (cloud.bloom.dev)
- [Cloud Platform Overview](https://bloom-platform-ten.vercel.app/docs/cloud/overview.md): Organizations, projects, apps, and role-based access control.
- [Build & Release Pipeline](https://bloom-platform-ten.vercel.app/docs/cloud/build-and-release.md): Remote build farm, release approvals, rollout percentages, and multi-target deployments.
- [Secrets, Signing & Git](https://bloom-platform-ten.vercel.app/docs/cloud/secrets-and-signing.md): Versioned secrets vault, signing identity management, and Git provider connections.
- [Hosting, Observability & Automation](https://bloom-platform-ten.vercel.app/docs/cloud/hosting-and-automation.md): Web hosting with custom domains, release health monitoring, workflow automation, and the template marketplace.
- [Open Cloud Dashboard](https://cloud.bloom.dev): The live Bloom Cloud dashboard application.

## Backend Adapters
- [Backend Adapters Overview](https://bloom-platform-ten.vercel.app/docs/framework/adapters.md): Multi-backend integration architecture.
- [Supabase Adapter](https://bloom-platform-ten.vercel.app/docs/adapters/supabase.md): Supabase Auth, Postgres Realtime Signals, and Storage.
- [Serverpod Adapter](https://bloom-platform-ten.vercel.app/docs/adapters/serverpod.md): Full-stack Dart RPC, WebSockets, and shared models.

## Bloom Server (Backend Ecosystem)
- [Bloom Server Overview](https://bloom-platform-ten.vercel.app/docs/server/overview.md): 15-package Django-style backend ecosystem sharing bloom_framework with the Flutter client.
- [Scaffolding a Server](https://bloom-platform-ten.vercel.app/docs/server/scaffolding.md): `bloom server create` and `bloom server startapp` scaffolding commands.
- [ORM & Migrations](https://bloom-platform-ten.vercel.app/docs/server/orm-and-migrations.md): bloom_db QuerySet API, Q()/F() expressions, and bloom_migrate schema migrations.
- [Authentication](https://bloom-platform-ten.vercel.app/docs/server/auth.md): bloom_auth_server session tokens, password hashing, and rate limiting.
- [Validation & Errors](https://bloom-platform-ten.vercel.app/docs/server/validation-and-errors.md): bloom_validate schema validation and bloom_errors typed exception hierarchy.
- [REST API Layer](https://bloom-platform-ten.vercel.app/docs/server/rest-api.md): bloom_rest DRF-style ViewSets, serializers, pagination, and permissions.
- [Admin Panel](https://bloom-platform-ten.vercel.app/docs/server/admin-panel.md): bloom_admin automatic server-rendered HTML administration interface.
- [Realtime & WebSockets](https://bloom-platform-ten.vercel.app/docs/server/realtime.md): bloom_realtime channels, broadcast, presence, and query invalidation bridge.
- [Caching](https://bloom-platform-ten.vercel.app/docs/server/caching.md): bloom_cache in-memory, database, and Redis caching backends.
- [Jobs, Mail & Storage](https://bloom-platform-ten.vercel.app/docs/server/jobs-mail-and-storage.md): bloom_jobs background queues, bloom_mail transactional email, and bloom_storage file storage.
- [i18n & Security](https://bloom-platform-ten.vercel.app/docs/server/i18n-and-security.md): bloom_i18n locale resolution and bloom_security CORS/headers/rate limiting.

## Testing & Diagnostics
- [Testing Strategy & Overview](https://bloom-platform-ten.vercel.app/docs/guides/testing.md): Unit, controller, widget, and E2E testing.
- [Bloom Testing Harness](https://bloom-platform-ten.vercel.app/docs/testing/harness.md): BloomTestContainer, mocks, and signal testing utilities.
- [Testing Recipes Cookbook](https://bloom-platform-ten.vercel.app/docs/testing/recipes.md): Ready-to-use testing recipes for production apps.

## Engineering Guides
- [Engineering Cookbook](https://bloom-platform-ten.vercel.app/docs/guides/cookbook.md): Real-world recipes: infinite scroll, file upload, auth, and biometrics.
- [Architectural Best Practices](https://bloom-platform-ten.vercel.app/docs/guides/best-practices.md): Production guidelines for signals, memory, and performance.
- [Migration Guide](https://bloom-platform-ten.vercel.app/docs/guides/migration.md): Migrating from raw Flutter, Riverpod, Bloc, and GetX to Bloom.
- [Contributing Guide](https://bloom-platform-ten.vercel.app/docs/guides/contributing.md): Open-source contribution workflow.
- [Troubleshooting & FAQ](https://bloom-platform-ten.vercel.app/docs/guides/troubleshooting.md): Common errors, solutions, and diagnostics.
- [Core API Reference](https://bloom-platform-ten.vercel.app/docs/guides/api-reference.md): Complete class, function, and interface signatures.
- [Platform Capabilities & Gaps](https://bloom-platform-ten.vercel.app/docs/transparency/platform-capabilities.md): Transparent ecosystem assessment.

## Bloom UI Primitives (34 Components)
- [Button (`BloomButton`)](https://bloom-platform-ten.vercel.app/ui/button.md): Displays a button or a component that looks like a button with 8 sizing steps, soft destructive tint, and loading state indicators. (`bloom ui add button`)
- [Button Group (`BloomButtonGroup`)](https://bloom-platform-ten.vercel.app/ui/button-group.md): A connected row of action buttons or toggle selectors with continuous border grouping. (`bloom ui add button_group`)
- [Input (`BloomInput`)](https://bloom-platform-ten.vercel.app/ui/input.md): Displays a 32px height calibrated form input field or a component that looks like an input field. (`bloom ui add input`)
- [Input Group (`BloomInputGroup`)](https://bloom-platform-ten.vercel.app/ui/input-group.md): Compose input fields with leading/trailing text addons, dropdown selects, and action buttons in a unified border container. (`bloom ui add input_group`)
- [Input OTP (`BloomInputOtp`)](https://bloom-platform-ten.vercel.app/ui/input-otp.md): Accessible one-time password / PIN entry with discrete animated slot boxes and separator styling. (`bloom ui add input_otp`)
- [Textarea (`BloomTextarea`)](https://bloom-platform-ten.vercel.app/ui/textarea.md): Multi-line expanded text input for paragraphs, descriptions, or code prompts. (`bloom ui add textarea`)
- [Checkbox (`BloomCheckbox`)](https://bloom-platform-ten.vercel.app/ui/checkbox.md): A 16x16px control that allows the user to toggle between checked, unchecked, and indeterminate states. (`bloom ui add checkbox`)
- [Radio Group (`BloomRadioGroup`)](https://bloom-platform-ten.vercel.app/ui/radio.md): A set of 16px circular check buttons where only one button can be checked at a time. (`bloom ui add radio`)
- [Switch (`BloomSwitch`)](https://bloom-platform-ten.vercel.app/ui/switch.md): A 32x18px control that allows the user to toggle between checked and unchecked states. (`bloom ui add switch`)
- [Slider (`BloomSlider`)](https://bloom-platform-ten.vercel.app/ui/slider.md): A 4px track slider with 12px white ring thumb for selecting values from a range. (`bloom ui add slider`)
- [Select (`BloomSelect`)](https://bloom-platform-ten.vercel.app/ui/select.md): Displays a 32px dropdown select picker matching shadcn base-nova styling. (`bloom ui add select`)
- [Combobox (`BloomCombobox`)](https://bloom-platform-ten.vercel.app/ui/combobox.md): Searchable autocomplete dropdown menu with multi-select tokenized chips support. (`bloom ui add combobox`)
- [Calendar (`BloomCalendar`)](https://bloom-platform-ten.vercel.app/ui/calendar.md): A date picker calendar component supporting single, range, and multiple date selections. (`bloom ui add calendar`)
- [Field (`BloomField`)](https://bloom-platform-ten.vercel.app/ui/field.md): A complete composable form field wrapper providing FieldLabel, FieldDescription, and FieldError slots. (`bloom ui add field`)
- [Card (`BloomCard`)](https://bloom-platform-ten.vercel.app/ui/card.md): Displays a card with title, description, content, action header slots, and a shaded border-divided footer. (`bloom ui add card`)
- [Accordion (`BloomAccordion`)](https://bloom-platform-ten.vercel.app/ui/accordion.md): A vertically stacked set of interactive headings that each reveal a section of content. (`bloom ui add accordion`)
- [Tabs (`BloomTabs`)](https://bloom-platform-ten.vercel.app/ui/tabs.md): A set of layered sections of content—known as tab panels—that are displayed one at a time. Supports pill and line underline variants. (`bloom ui add tabs`)
- [Skeleton (`BloomSkeleton`)](https://bloom-platform-ten.vercel.app/ui/skeleton.md): Used to show a placeholder while content is loading with a subtle pulse animation. (`bloom ui add skeleton`)
- [Progress (`BloomProgress`)](https://bloom-platform-ten.vercel.app/ui/progress.md): Displays a 4px height linear progress bar indicating completion of an operation. (`bloom ui add progress`)
- [Dialog (`BloomDialog`)](https://bloom-platform-ten.vercel.app/ui/dialog.md): A modal window that appears in front of app content with shaded footer and compound title/description slots. (`bloom ui add dialog`)
- [Alert Dialog (`BloomAlertDialog`)](https://bloom-platform-ten.vercel.app/ui/alert-dialog.md): A modal dialog that interrupts the user with important content and expects a response. (`bloom ui add alert_dialog`)
- [Alert (`BloomAlert`)](https://bloom-platform-ten.vercel.app/ui/alert.md): Displays a callout for user attention with 10x8px padding and soft status tints. (`bloom ui add alert`)
- [Sheet (`BloomSheet`)](https://bloom-platform-ten.vercel.app/ui/sheet.md): Extends the Dialog component to display 4-directional slide-over drawers (left, right, top, bottom). (`bloom ui add sheet`)
- [Drawer (`BloomDrawer`)](https://bloom-platform-ten.vercel.app/ui/drawer.md): A swipeable gesture bottom sheet with drag handle and spring snap points. (`bloom ui add drawer`)
- [Sonner / Toast (`BloomSonner`)](https://bloom-platform-ten.vercel.app/ui/sonner.md): An opinionated toast notification system with success, error, warning, and loading status styles. (`bloom ui add sonner`)
- [Dropdown Menu (`BloomDropdownMenu`)](https://bloom-platform-ten.vercel.app/ui/dropdown-menu.md): Displays a menu to the user—such as a set of actions or functions—triggered by a button. (`bloom ui add dropdown_menu`)
- [Avatar (`BloomAvatar`)](https://bloom-platform-ten.vercel.app/ui/avatar.md): An image element with a fallback monogram for representing the user with 24/32/40px sizes and AvatarGroup. (`bloom ui add avatar`)
- [Badge & Chip (`BloomBadge`)](https://bloom-platform-ten.vercel.app/ui/badge.md): Displays a 20px pill badge or interactive BloomChip with soft destructive and status tints. (`bloom ui add badge`)
- [Kbd (`BloomKbd`)](https://bloom-platform-ten.vercel.app/ui/kbd.md): A 20px height sans-serif keyboard shortcut token matching shadcn base-nova specifications. (`bloom ui add kbd`)
- [Table & Data Table (`BloomTable`)](https://bloom-platform-ten.vercel.app/ui/table.md): A responsive data table container with 40px headers, cell alignment, and sortable columns. (`bloom ui add table`)
- [Sidebar (`BloomSidebar`)](https://bloom-platform-ten.vercel.app/ui/sidebar.md): A composable, collapsible navigation sidebar system matching shadcn base-nova with groups, headers, and footer slots. (`bloom ui add sidebar`)
- [Charts Suite (`BloomChart`)](https://bloom-platform-ten.vercel.app/ui/chart.md): Pure Dart token-driven chart suite supporting Area, Bar, Line, Pie, Radar, and Radial charts with responsive drag tracking. (`bloom ui add chart`)
- [Command Palette (`BloomCommandPalette`)](https://bloom-platform-ten.vercel.app/ui/command-palette.md): Fast, accessible command menu for searching actions, files, and navigation shortcuts. (`bloom ui add command_palette`)
- [App & Dashboard Shell (`BloomDashboardShell`)](https://bloom-platform-ten.vercel.app/ui/app-shell.md): Production responsive application frame combining top bar, collapsible sidebar, and responsive mobile nav. (`bloom ui add app_shell`)

## Legal & Governance
- [Privacy Policy](https://bloom-platform-ten.vercel.app/privacy.md): Transparent data governance, local processing guarantees, and telemetry policies.
- [Terms and Conditions](https://bloom-platform-ten.vercel.app/terms.md): Open-source MIT terms, zero lock-in user ownership, and cloud usage rules.

## Full Consolidated Documentation
- [Full Consolidated Context (llms-full.txt)](https://bloom-platform-ten.vercel.app/llms-full.txt): Complete single-file documentation combining all guides, runtime specifications, CLI commands, and 34 UI primitive references.