🏛️ Bloquinho Architecture

A modern, modular and extensible platform that combines local data organization, cloud synchronization and Notion-like interface to offer total control over your information.

🌐 Architecture Overview

Bloquinho was designed to be a complete productivity platform, inspired by the best standards of organization and privacy. Its architecture combines:

📊 System Architecture

flowchart TD subgraph User U["👤 User"] end subgraph App["📱 Bloquinho App"] direction TB UI["🎨 Interface (Flutter)"] Theme["🎨 Theme & Icon System"] Nav["🧭 Navigation & Sidebar"] Notion["📝 Notion-like Editor\n(Blocks, Hierarchy, Slash Commands)"] Search["🔍 Global Search"] CloudSync["☁️ Sync Indicator\n(CloudSyncStatusProvider)"] Providers["⚙️ Riverpod Providers\n(Global State)"] end subgraph Persistence Local["💾 Local Storage\n(LocalStorageService)"] Cloud["☁️ Cloud (Google Drive, OneDrive)\n(CloudFolderService)"] end subgraph Structure Profile["📁 profile/[profile_name]/settings.json"] Workspaces["📂 workspaces/\n├─ work/\n├─ personal/\n└─ school/"] Modules["📋 Each workspace:\n├─ bloquinho/\n├─ documents/\n├─ agenda/\n├─ passwords/\n└─ databases/"] Bloquinho["📄 bloquinho/\n├─ bloquinho.md\n├─ Subpage1/\n│ └─ Subpage1.md\n└─ ..."] end U --> UI UI --> Nav UI --> Notion UI --> Search UI --> CloudSync UI --> Theme Nav --> Providers Notion --> Providers Search --> Providers CloudSync --> Providers Providers --> Local Providers --> Cloud Local --> Profile Local --> Workspaces Workspaces --> Modulos Modulos --> Bloquinho Cloud --> Estrutura classDef bloco fill:#f9f,stroke:#333,stroke-width:2px; class Notion,Bloquinho bloco;

🗂️ Data Organization

Each user has an organized and hierarchical structure:

  • Profile: Exclusive folder with settings and photo
  • Workspaces: Three default spaces (work, personal, school)
  • Modules: Five modules per workspace
  • Hierarchy: Structure of pages and subpages

☁️ Synchronization and Cloud

Hybrid system that ensures privacy and accessibility:

  • Local First: All data saved locally
  • Cloud Sync: Google Drive and OneDrive integrated
  • Persistent OAuth2: Single login with automatic renewal
  • Visual Indicator: Real-time synchronization status

📁 Folder Structure

Example of hierarchical data organization:

profile/ └── karim_santos/ ├── settings.json ├── profile_photo.jpg └── workspaces/ ├── work/ │ ├── bloquinho/ │ │ ├── bloquinho.md │ │ └── Subpagina1/ │ │ └── Subpagina1.md │ ├── documents/ │ ├── agenda/ │ ├── passwords/ │ └── databases/ ├── personal/ └── school/

🧩 Key Components

Main features that define the experience:

  • Notion-like Editor: Rich blocks, slash commands, hierarchy
  • Global Search: Instant search across all modules
  • Sidebar & Navigation: Responsive and intuitive interface
  • Theme System: Consistent and customizable visual
  • Sync Indicator: Continuous visual feedback

🛡️ Security and Privacy

Total protection of user data:

  • Secure Local Storage: Encrypted data
  • Total Control: Export, import, backup
  • Open Source: Open source and auditable code
  • No Data to Third Parties: Guaranteed privacy

🚀 Initialization Flow

1

App Starts

Loads profile and current workspace automatically

2

Riverpod Providers

Initialize global state and data management

3

OAuth2Service

Restores sessions and authentication tokens

4

CloudFolderService

Ensures cloud folder structure

5

Interface Ready

Displays status, navigation and modules ready for use

🎨 Integrated Design

Bloquinho's design was conceived to convey lightness, organization and professionalism, with rounded cards, beige/light brown palette, large and colorful icons, clear typography and smooth animations.

🌟 Conclusion

Bloquinho's architecture unites the best of productivity, privacy and modern design. With a robust foundation, intelligent synchronization and Notion-inspired interface, Bloquinho is the definitive solution for those seeking total control over their information, on any platform.