This document provides a high-level introduction to the bit platform, a comprehensive toolkit for building Blazor applications that target multiple platforms from a single codebase. The bit platform encompasses four core libraries (Bit.BlazorUI, Bit.Bswup, Bit.Butil, Bit.Besql), a project template system (Bit.Boilerplate), build infrastructure, and deployment tooling that enables creation of Progressive Web Apps (PWAs), mobile applications, and desktop applications.
For detailed information about specific subsystems:
The bit platform is a complete development ecosystem for Blazor applications, consisting of interconnected libraries and tools that address common challenges in modern web and cross-platform application development. The platform emphasizes performance, offline support, and multi-platform deployment while maintaining a single C# codebase.
Sources: README.md15-29
The platform provides four primary libraries that work independently or together:
| Library | Purpose | Package Size | Key Features |
|---|---|---|---|
| Bit.BlazorUI | UI component library | <400 KB total | 80+ components, dark/light themes, Fluent/Material/Cupertino design systems |
| Bit.Bswup | PWA and service worker | Minimal overhead | Pre-rendering, offline support, cache management |
| Bit.Butil | Browser APIs in C# | Small | Direct browser API access without JavaScript |
| Bit.Besql | Offline database | SQLite bundle | EF Core + SQLite in browser, sync capabilities |
Sources: README.md17-25
The Bit.Boilerplate template (dotnet new install Bit.Boilerplate) generates production-ready projects with:
Sources: README.md27
The following diagram shows how the core libraries, templates, and deployment targets interconnect within the bit platform ecosystem:
Sources: README.md15-29 src/Templates/Boilerplate/Bit.Boilerplate/
This diagram maps the high-level library concepts to their actual implementation locations in the repository:
Sources: src/BlazorUI/ src/Bswup/ src/Butil/ src/Besql/ src/Templates/Boilerplate/
Applications generated from the Bit.Boilerplate template follow a layered architecture where shared code in Client.Core is referenced by platform-specific projects:
Sources: src/Templates/Boilerplate/Bit.Boilerplate/src/
The bit platform provides several open-source demonstration applications showcasing different deployment configurations:
| Application | Description | Deployment Type | URL |
|---|---|---|---|
| bitplatform.dev | Marketing website | .NET 10 Pre-rendered PWA | bitplatform.dev |
| blazorui.bitplatform.dev | Component showcase | .NET 10 Pre-rendered PWA | blazorui.bitplatform.dev |
| adminpanel.bitplatform.dev | Admin template | .NET 10 PWA | adminpanel.bitplatform.dev |
| todo.bitplatform.dev | Todo app template | .NET 10 Pre-rendered PWA | todo.bitplatform.dev |
| sales.bitplatform.dev | Sales module | .NET 10 Pre-rendered PWA | sales.bitplatform.dev |
Sources: README.md37-58
The Todo, AdminPanel, and BlazorUI demo applications are available across five platforms:
| Platform | Distribution Method | Example |
|---|---|---|
| Web (PWA) | Azure Web App + Cloudflare CDN | todo.bitplatform.dev |
| iOS | Apple App Store | iOS App Store links |
| Android | Google Play Store | Play Store links |
| Windows | Direct download (Velopack installer) | .exe installers |
| macOS | Apple App Store | Mac App Store links |
Sources: README.md41-47
Additional deployment variants demonstrating specific capabilities:
| URL | Configuration | Key Feature |
|---|---|---|
| todo-aot.bitplatform.cc | .NET 10 AOT Compiled | Ahead-of-Time compilation for smaller size |
| todo-small.bitplatform.cc | Minimal build | Reduced download footprint |
| todo-offline.bitplatform.cc | Full offline | EF Core + SQLite with sync |
| adminpanel.bitplatform.cc | Standalone WASM | Azure Static Web Apps deployment |
Sources: README.md52-57
The bit platform libraries are distributed via NuGet.org under the bit-foundation organization profile:
All packages share the same version number (10.4.2) managed centrally via Bit.Build.props.
Total Downloads: 8.8M+ across all packages
Sources: README.md8 src/Websites/Platform/src/Bit.Websites.Platform.Client/Pages/AboutUsPage.razor48-49 src/Templates/Boilerplate/Bit.Boilerplate/src/Client/Boilerplate.Client.Core/Components/Pages/Home/HomePage.razor128
The version number is defined once in Bit.Build.props and referenced throughout the build system:
Bit.Build.props (root configuration)
├── Version: 10.4.2
├── Package metadata (authors, license, repository URL)
└── Signing configuration
Sources: Build system diagrams, Bit.Build.props (referenced in context)
The bit platform leverages the following core technologies:
bit-bswup.sw.ts.ts sourcesSources: Build pipeline and architecture diagrams, template structure
| Feature Category | Capabilities | Implementation |
|---|---|---|
| UI Components | 80+ Blazor components, 3 design systems | Bit.BlazorUI library |
| Offline Support | Service worker caching, offline database | Bit.Bswup, Bit.Besql |
| Performance | AOT compilation, lazy loading, <400KB bundle | Build configuration, component design |
| Multi-Platform | Single codebase → 5 platforms | Boilerplate template structure |
| Localization | 10+ languages with RTL support | AppStrings.resx resource files |
| Pre-rendering | SEO-friendly server-side rendering | Server.Web project |
| Authentication | Password, OAuth, 2FA, WebAuthn | ASP.NET Core Identity integration |
| Real-time | SignalR hubs and streaming | Optional SignalR configuration |
| Background Jobs | Email, SMS, push notifications | Hangfire with Redis/EF storage |
| AI Integration | Chat clients, embeddings, vector search | Microsoft.Extensions.AI, pgvector |
Sources: README.md15-27 src/Websites/Platform/src/Bit.Websites.Platform.Client/Pages/Lcnc/LcncPage.razor81-90
To begin using the bit platform:
Install the template:
Create a new project:
Install individual libraries:
For detailed setup instructions, see Getting Started.
For information about template configuration options (database backend, authentication providers, feature flags), see Template Configuration System.
Sources: README.md27-29
The bit platform is open-source and actively maintained on GitHub:
For contribution guidelines, see CONTRIBUTING.md in the repository root.
Sources: README.md63-69 src/Websites/Platform/src/Bit.Websites.Platform.Client/Pages/Lcnc/LcncPage.razor140-145
Refresh this wiki
This wiki was recently refreshed. Please wait 3 days to refresh again.
