{"id":29813382,"url":"https://github.com/sen2pi/bloquinho","last_synced_at":"2026-04-09T17:37:14.411Z","repository":{"id":296877893,"uuid":"994818028","full_name":"Sen2pi/Bloquinho","owner":"Sen2pi","description":"Uma WebApp do genero de notion para correr on permises ","archived":false,"fork":false,"pushed_at":"2025-07-20T01:46:40.000Z","size":107681,"stargazers_count":1,"open_issues_count":17,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-28T19:01:49.904Z","etag":null,"topics":["agenda","data-analysis","data-visualization","database","education","markdown","note-taking","notebook","notebooks","notepad","notes","notes-app","notion","obsidian","password","password-generator","password-manager","password-safety","passwords","personal-blog"],"latest_commit_sha":null,"homepage":"https://bloquinho.kpsolucoes.pt","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Sen2pi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-02T14:25:23.000Z","updated_at":"2025-07-19T17:22:18.000Z","dependencies_parsed_at":"2025-07-17T21:50:55.718Z","dependency_job_id":null,"html_url":"https://github.com/Sen2pi/Bloquinho","commit_stats":null,"previous_names":["sen2pi/bloquinho"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Sen2pi/Bloquinho","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sen2pi%2FBloquinho","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sen2pi%2FBloquinho/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sen2pi%2FBloquinho/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sen2pi%2FBloquinho/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sen2pi","download_url":"https://codeload.github.com/Sen2pi/Bloquinho/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sen2pi%2FBloquinho/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278708035,"owners_count":26031932,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agenda","data-analysis","data-visualization","database","education","markdown","note-taking","notebook","notebooks","notepad","notes","notes-app","notion","obsidian","password","password-generator","password-manager","password-safety","passwords","personal-blog"],"created_at":"2025-07-28T19:00:43.682Z","updated_at":"2025-10-07T01:48:04.196Z","avatar_url":"https://github.com/Sen2pi.png","language":"Dart","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/images/logo.png\" alt=\"Bloquinho Logo\" width=\"120\"/\u003e\n  \u003cimg src=\"assets/images/BloquinhoAi.png\" alt=\"Bloquinho Logo\" width=\"120\"/\u003e\n  \u003ch1\u003eBloquinho\u003c/h1\u003e\n  \u003ch3\u003eProfessional Self-Hosted Workspace — 100% Flutter\u003c/h3\u003e\n  \u003cp\u003eYour private, offline, cross-platform Notion alternative with no limits.\u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Flutter-3.19%2B-blue?logo=flutter\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Platforms-Windows%20%7C%20Web%20%7C%20Linux%20%7C%20macOS-red\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Internationalization-PT%20%7C%20EN%20%7C%20FR-blueviolet\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/PT-100%25%20Complete-brightgreen\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/EN-68.5%25%20Complete-yellow\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/FR-68.5%25%20Complete-yellow\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Cloud%20Sync-Google%20Drive%20%7C%20OneDrive-blue\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/100%25%20Self--Hosted-success\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Status-68.5%25%20Complete-orange\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Functional-100%25%20Complete-brightgreen\"/\u003e\n\u003c/div\u003e\n\n---\n\n# ✨ What is Bloquinho?\n\n**Bloquinho** is a professional workspace inspired by Notion, built with Flutter, offering a complete self-hosted solution for personal and professional organization. It provides rich text editing, database management, agenda integration, cloud synchronization, and complete privacy control.\n\n\u003e **No paid plans. No limits on blocks, pages, or users. 100% offline and private.**\n\n## 🚀 Future Features\n\nWe have an exciting roadmap planned for Bloquinho! Here are the upcoming features that will transform it into a comprehensive productivity platform:\n\n### 📊 Database Integration \u0026 Note Management\n\n#### **Smart Note Database**\n- **Cloud Synchronization**: Seamless sync across all devices with real-time collaboration\n- **Advanced Search**: Full-text search with filters by date, tags, and content type\n- **Version History**: Complete revision tracking with diff visualization\n- **Backup \u0026 Recovery**: Automated backups with point-in-time recovery\n- **Import/Export**: Support for popular formats (Notion, Obsidian, OneNote, etc.)\n\n#### **Intelligent Note Linking**\n- **Bi-directional Links**: Automatic relationship mapping between related notes\n- **Graph Visualization**: Interactive knowledge graph showing note connections\n- **Backlinks Panel**: See all notes that reference the current document\n- **Smart Suggestions**: AI-powered recommendations for related content\n- **Tag Hierarchies**: Nested tagging system with auto-completion\n\n### 📅 Calendar \u0026 Agenda Integration\n\n#### **Unified Calendar System**\n- **Multi-Calendar Support**: Google Calendar, Outlook, Apple Calendar integration\n- **Note-to-Event Linking**: Connect meeting notes directly to calendar events\n- **Smart Scheduling**: AI-assisted time blocking and scheduling suggestions\n- **Deadline Tracking**: Automatic reminders and progress tracking\n- **Time Analytics**: Detailed insights into time allocation and productivity patterns\n\n#### **Task Management**\n- **GTD Methodology**: Complete Getting Things Done workflow implementation\n- **Kanban Boards**: Visual project management with drag-and-drop functionality\n- **Recurring Tasks**: Flexible scheduling for habits and regular activities\n- **Priority Matrix**: Eisenhower matrix for task prioritization\n- **Team Collaboration**: Shared projects and task assignment\n\n### 🎓 Academic Management System\n\n#### **Student Information System**\n- **Course Management**: Semester planning, credit tracking, and GPA calculation\n- **Assignment Tracker**: Deadline management with automatic reminders\n- **Grade Book**: Comprehensive gradebook with statistical analysis\n- **Study Planner**: Intelligent study scheduling based on course load\n- **Research Tools**: Citation management and bibliography generation\n\n#### **Educational Features**\n- **Flashcard System**: Spaced repetition algorithm for optimal learning\n- **Note Templates**: Pre-designed templates for different subjects\n- **Collaboration Tools**: Study groups and peer review functionality\n- **Progress Analytics**: Learning analytics and performance insights\n- **Integration Hub**: Canvas, Moodle, and other LMS integrations\n\n### 💰 Financial Management System\n\n#### **Personal Finance Dashboard**\n- **Expense Tracking**: Automated categorization and budget monitoring\n- **Income Management**: Multiple income streams tracking\n- **Investment Portfolio**: Real-time portfolio tracking and analysis\n- **Financial Goals**: SMART goal setting with progress visualization\n- **Reporting Suite**: Comprehensive financial reports and insights\n\n#### **Advanced Financial Tools**\n- **Cash Flow Forecasting**: Predictive financial planning\n- **Tax Management**: Document organization and deduction tracking\n- **Bill Reminders**: Automatic bill scheduling and payment alerts\n- **Financial Analytics**: Spending patterns and optimization recommendations\n- **Multi-Currency Support**: Global currency tracking and conversion\n\n### 🔗 Cross-Platform Integration\n\n#### **Seamless Ecosystem**\n- **Mobile Applications**: Native iOS and Android apps with offline support\n- **Web Platform**: Full-featured web application with PWA capabilities\n- **Desktop Sync**: Real-time synchronization across Windows, macOS, and Linux\n- **API Ecosystem**: RESTful API for third-party integrations\n- **Plugin Architecture**: Extensible system for community-developed features\n\n#### **Smart Automation**\n- **Workflow Engine**: Visual automation builder for complex workflows\n- **AI Assistant**: Intelligent assistant for note organization and suggestions\n- **Template Engine**: Dynamic templates with conditional logic\n- **Integration Marketplace**: Pre-built integrations with popular tools\n- **Custom Scripting**: Advanced automation with custom scripts\n\n### 📈 Analytics \u0026 Insights\n\n#### **Productivity Intelligence**\n- **Usage Analytics**: Detailed insights into writing patterns and productivity\n- **Goal Tracking**: Progress monitoring with visual dashboards\n- **Time Investment**: Analysis of time spent on different projects\n- **Content Analytics**: Word count, reading time, and complexity metrics\n- **Habit Formation**: Behavioral insights for building better habits\n\n#### **Collaboration Analytics**\n- **Team Performance**: Collaboration metrics and team productivity insights\n- **Knowledge Sharing**: Track knowledge distribution and expertise mapping\n- **Communication Patterns**: Analysis of collaboration effectiveness\n- **Project Insights**: Timeline analysis and milestone tracking\n- **Resource Optimization**: Recommendations for improved efficiency\n\n---\n\n### 🗓️ Development Timeline\n\n| Phase | Features | Target Quarter |\n|-------|----------|----------------|\n| **Phase 1** | Database Integration, Note Linking | Q3 2025 |\n| **Phase 2** | Calendar Integration, Basic Task Management | Q4 2025 |\n| **Phase 3** | Academic Management System | Q1 2026 |\n| **Phase 4** | Financial Management System | Q2 2026 |\n| **Phase 5** | Advanced Analytics, AI Features | Q3 2026 |\n\n### 🤝 Get Involved\n\nWe believe in community-driven development! Here's how you can contribute to these future features:\n\n- **Feature Requests**: Submit ideas via GitHub Issues\n- **Beta Testing**: Join our early access program\n- **Community Feedback**: Participate in feature discussions\n- **Development**: Contribute code for priority features\n- **Documentation**: Help improve our documentation\n\n---\n\n**Stay Updated**: Follow our [GitHub repository](https://github.com/Sen2pi/Bloquinho) for the latest development updates and feature announcements.\n\n*Have a feature idea not listed here? We'd love to hear from you! Open an issue and let's discuss how to make Bloquinho even better.*\n\n## 🚀 Key Features\n\n### 📝 **Notion-like Editor**\n- **37 Block Types**: Text, headings, lists, tasks, code, quotes, images, tables, links, embeds, and more\n- **Slash Commands**: 20+ commands with real-time search (`/text`, `/h1`, `/list`, `/todo`, `/code`, `/table`, `/page`)\n- **Rich Text Formatting**: Bold, italic, strikethrough, underline, code, colors, and links\n- **Markdown Conversion**: Automatic conversion when pasting markdown content\n- **Endless Page**: Infinite scrolling with optimized performance\n- **Real-time Preview**: Split editor with live markdown preview\n- **Auto-save**: Intelligent saving with 2-second debounce\n- **Visual Status**: \"Saving.../Saved\" indicators\n\n### 🗂️ **Hierarchical Pages**\n- **Infinite Subpages**: Create unlimited nested pages\n- **Breadcrumb Navigation**: Visual hierarchy navigation\n- **Page Tree Widget**: Professional sidebar with indentation and connector lines\n- **Context Menus**: 6 options (subpage, favorite, duplicate, rename, delete)\n- **Visual Indicators**: Page counters, favorites, and status icons\n\n### 🗄️ **Integrated Database**\n- **17 Field Types**: Text, number, checkbox, select, multi-select, date, deadline, status, rating, progress, file, image, relation, formula, and more\n- **Mathematical Operations**: Advanced formulas and calculations\n- **Multiple Views**: Table, Kanban, calendar views\n- **Complete CRUD**: Add, edit, remove records with full validation\n- **Advanced Search**: Filters and search across all data\n- **Workspace Isolation**: Each workspace has independent databases\n\n### 📅 **Agenda \u0026 Kanban**\n- **Calendar Views**: Monthly, weekly, daily visualizations\n- **Kanban Boards**: Drag \u0026 drop with custom statuses\n- **Database Integration**: Deadlines automatically appear in agenda\n- **Bidirectional Sync**: Changes reflect in both systems\n- **Event Management**: Create, edit, and manage events\n\n### ☁️ **Backup \u0026 Cloud Sync**\n- **Local Backup**: Complete JSON backup with flexible restoration\n- **Automatic Backup**: Scheduled backups with history retention\n- **Cloud Synchronization**: Google Drive and OneDrive integration\n- **OAuth2 Authentication**: Secure real-time authentication\n- **Restoration Options**: Merge or replace data\n- **Export/Import**: Transfer data between devices\n\n### 🌍 **Multi-language Support**\n- **3 Languages**: Portuguese (PT-BR), English (EN-US), French (FR-FR)\n- **100% Translated**: All screens, menus, dialogs, and messages\n- **Real-time Switching**: Change language anytime in settings\n- **Localized Validation**: Form validation messages in all languages\n\n### 🔐 **Security \u0026 Privacy**\n- **100% Local**: No data leaves your device without permission\n- **Encryption**: Sensitive data protection\n- **No Telemetry**: No analytics, tracking, or data collection\n- **Self-hosted**: You control everything\n- **OAuth2 Security**: Secure cloud authentication\n\n### 🎨 **Professional Interface**\n- **Dark/Light Mode**: Complete theme support\n- **Custom Icons**: Professional icon system\n- **Responsive Design**: Works on all screen sizes\n- **Workspace Isolation**: Multiple contexts with independent data\n- **Modern UI**: Material Design 3 with custom components\n\n## 🏗️ Architecture \u0026 Technology\n\n### **Flutter Architecture**\n```mermaid\ngraph TD;\n  A[Onboarding] --\u003e B[Profile Creation]\n  B --\u003e C[Workspace Setup]\n  C --\u003e D[Notion-like Editor]\n  D --\u003e E[Database System]\n  D --\u003e F[Agenda/Kanban]\n  D --\u003e G[Backup/Sync]\n  G --\u003e H[Google Drive/OneDrive]\n  D --\u003e I[Settings/Language]\n  D --\u003e J[Custom Sidebar]\n```\n\n### **Core Technologies**\n- **Flutter 3.19+**: Cross-platform development\n- **Riverpod**: Reactive state management\n- **Hive**: Local data persistence\n- **GoRouter**: Navigation system\n- **OAuth2**: Cloud authentication\n- **Phosphor Icons**: Consistent iconography\n\n### **Data Structure**\n```\nprofile/\n├── user_profile.json\n├── settings.json\n└── workspaces/\n    ├── personal/\n    │   ├── bloquinho/\n    │   ├── database/\n    │   ├── agenda/\n    │   ├── documents/\n    │   └── passwords/\n    └── work/\n        └── [same structure]\n```\n\n## 🚀 Quick Start\n\n### **Prerequisites**\n- **Flutter 3.19+** installed\n- **Git** for version control\n- **Platform-specific tools** (see build guides below)\n\n### **Installation**\n```bash\n# Clone the repository\ngit clone https://github.com/Sen2pi/Bloquinho.git\ncd Bloquinho\n\n# Install dependencies\nflutter pub get\n\n# Run on your preferred platform\nflutter run -d windows    # Windows\nflutter run -d macos      # macOS\nflutter run -d linux      # Linux\nflutter run -d chrome     # Web\n```\n\n## 🛠️ Build Guides\n\n### **Linux Build Guide**\n\n#### **Ubuntu/Debian**\n```bash\n# Install dependencies\nsudo apt update\nsudo apt install -y \\\n    clang \\\n    cmake \\\n    ninja-build \\\n    pkg-config \\\n    libgtk-3-dev \\\n    liblzma-dev \\\n    libstdc++-12-dev\n\n# Install Flutter\nsudo snap install flutter --classic\n# OR download from https://flutter.dev/docs/get-started/install/linux\n\n# Verify installation\nflutter doctor\n\n# Build and run\ncd Bloquinho\nflutter pub get\nflutter run -d linux\n```\n\n#### **Fedora/RHEL**\n```bash\n# Install dependencies\nsudo dnf install -y \\\n    clang \\\n    cmake \\\n    ninja-build \\\n    pkg-config \\\n    gtk3-devel \\\n    xz-devel \\\n    libstdc++-devel\n\n# Continue with Flutter installation...\n```\n\n### **macOS Build Guide**\n\n#### **System Requirements**\n- **macOS 10.14+** (Mojave or later)\n- **Xcode 12+** with Command Line Tools\n- **Flutter 3.19+**\n\n#### **Installation Steps**\n```bash\n# Install Homebrew (if not installed)\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n\n# Install Xcode Command Line Tools\nxcode-select --install\n\n# Install Flutter via Homebrew\nbrew install --cask flutter\n\n# OR download manually from https://flutter.dev/docs/get-started/install/macos\n\n# Verify installation\nflutter doctor\n\n# Build and run\ncd Bloquinho\nflutter pub get\nflutter run -d macos\n```\n\n#### **Troubleshooting macOS**\n```bash\n# If you get signing errors\nflutter config --enable-macos-desktop\n\n# If you need to accept licenses\nflutter doctor --android-licenses\n\n# For M1 Macs, ensure you're using the right architecture\narch -x86_64 flutter run -d macos  # If needed\n```\n\n### **Cross-Platform Development**\n\n#### **Enable Desktop Support**\n```bash\n# Enable all desktop platforms\nflutter config --enable-windows-desktop\nflutter config --enable-macos-desktop\nflutter config --enable-linux-desktop\n\n# Verify available devices\nflutter devices\n```\n\n#### **Build for Distribution**\n```bash\n# Build release versions\nflutter build windows --release\nflutter build macos --release\nflutter build linux --release\nflutter build web --release\n\n# Output locations\n# Windows: build/windows/runner/Release/\n# macOS: build/macos/Build/Products/Release/\n# Linux: build/linux/x64/release/bundle/\n# Web: build/web/\n```\n\n## 📱 Platform Support\n\n| Platform | Status | Notes |\n|----------|--------|-------|\n| **Windows** | ✅ Full Support | Native desktop app |\n| **macOS** | ✅ Full Support | Native desktop app |\n| **Linux** | ✅ Full Support | Native desktop app |\n| **Web** | ✅ Full Support | Progressive Web App |\n| **Android** | 🔄 In Development | Mobile app planned |\n| **iOS** | 🔄 In Development | Mobile app planned |\n\n## 🎯 Advanced Features\n\n### **OAuth2 Cloud Integration**\n- **Google Drive**: Real-time sync with OAuth2 authentication\n- **OneDrive**: Microsoft Graph API integration\n- **Dynamic Ports**: Automatic port selection for callbacks\n- **Secure Storage**: Encrypted token management\n- **Auto-refresh**: Automatic token renewal\n\n### **Avatar System**\n- **OAuth2 Integration**: Automatic avatar download from Google/Microsoft\n- **Local Cache**: Intelligent caching with metadata\n- **Cross-platform**: URL support for web, file support for mobile\n- **Fallback System**: Initials when no avatar available\n- **Auto-cleanup**: Automatic cache management\n\n### **Workspace Management**\n- **Multiple Contexts**: Personal, Work, Studies workspaces\n- **Isolated Data**: Each workspace has independent data\n- **Custom Icons**: Professional icon selection\n- **Color Themes**: Workspace-specific color schemes\n- **Quick Actions**: Fast workspace switching\n\n### **Database System**\n- **17 Field Types**: Complete data modeling\n- **Mathematical Operations**: Advanced calculations\n- **File Attachments**: Document and image support\n- **Status Tracking**: Progress and deadline management\n- **Formula Engine**: Custom calculations and relationships\n\n## 🔧 Development\n\n### **Project Structure**\n```\nlib/\n├── core/                    # Core services and models\n│   ├── constants/          # App constants\n│   ├── l10n/              # Internationalization\n│   ├── models/            # Data models\n│   ├── services/          # Business logic\n│   └── theme/             # UI theming\n├── features/              # Feature modules\n│   ├── agenda/           # Calendar and events\n│   ├── auth/             # Authentication\n│   ├── backup/           # Backup system\n│   ├── bloquinho/        # Main editor\n│   ├── database/         # Database system\n│   ├── documentos/       # Document management\n│   ├── passwords/        # Password manager\n│   ├── profile/          # User profiles\n│   ├── settings/         # App settings\n│   └── workspace/        # Workspace management\n├── shared/               # Shared components\n│   ├── models/           # Shared models\n│   ├── providers/        # State management\n│   └── widgets/          # Reusable widgets\n└── main.dart             # App entry point\n```\n\n### **Key Dependencies**\n```yaml\ndependencies:\n  flutter_riverpod: ^2.4.9    # State management\n  go_router: ^12.1.3          # Navigation\n  hive: ^2.2.3               # Local storage\n  phosphor_flutter: ^2.0.1    # Icons\n  oauth2: ^2.0.2             # Cloud authentication\n  url_launcher: ^6.2.1       # URL handling\n  flutter_secure_storage: ^9.0.0  # Secure storage\n  path_provider: ^2.1.1      # File system\n  intl: ^0.18.1              # Internationalization\n  crypto: ^3.0.3             # Hashing\n  uuid: ^4.1.0               # Unique IDs\n```\n\n### **Testing**\n```bash\n# Run all tests\nflutter test\n\n# Run specific test file\nflutter test test/user_profile_test.dart\n\n# Run with coverage\nflutter test --coverage\n```\n\n## 📊 Performance Metrics\n\n### **Current Status**\n- **99.8% Complete**: All core features implemented\n- **37 Block Types**: Complete Notion-like editor\n- **20+ Slash Commands**: Professional editing experience\n- **3 Languages**: Full internationalization\n- **2 Cloud Providers**: Google Drive + OneDrive\n- **4 Platforms**: Windows, macOS, Linux, Web\n\n### **Performance Benchmarks**\n- **Startup Time**: \u003c3 seconds\n- **Editor Response**: \u003c100ms\n- **Auto-save**: 2-second debounce\n- **Memory Usage**: Optimized for desktop\n- **File Size**: \u003c50MB per platform\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### **Development Setup**\n```bash\n# Fork and clone\ngit clone https://github.com/your-username/Bloquinho.git\ncd Bloquinho\n\n# Install dependencies\nflutter pub get\n\n# Run tests\nflutter test\n\n# Start development\nflutter run -d windows  # or your preferred platform\n```\n\n### **Code Style**\n- Follow Flutter/Dart conventions\n- Use meaningful variable names\n- Add comments for complex logic\n- Write tests for new features\n- Update documentation\n\n## 📄 License\n\nThis project is licensed under **CC BY-NC-SA 4.0** - see the [LICENSE](LICENSE) file for details.\n\n- ✅ **Non-commercial use**: Free for personal, educational, and research purposes\n- ❌ **Commercial use**: Prohibited without permission\n- 📧 **Commercial licensing**: Contact [dr.karim.patatas@gmail.com] for commercial rights\n\n**Note**: This license change protects the project from unauthorized commercial use while keeping it accessible for the community.\n\n\n## 💝 Support \u0026 Donate\n\nBloquinho is a free, open-source project made with ❤️ for everyone. Your support helps keep the platform free, private, and innovative for thousands of people.\n\n### **Why Donate?**\n- **Keep it Free**: No paid plans or limitations\n- **Support Development**: Independent development and innovation\n- **Privacy First**: Your data stays yours\n- **Open Source**: Transparent and community-driven\n\n### **Donation Options**\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/images/qrcode.png\" alt=\"PayPal QR Code\" width=\"120\"/\u003e\n  \n  **PayPal**: [Donate via PayPal](https://paypal.me/your-paypal-link)\n  \n  **Contact**: dr.karim.patatas@gmail.com\n\u003c/div\u003e\n\n### **Connect With Us**\n- **Email**: dr.karim.patatas@gmail.com\n- **LinkedIn**: [linkedin.com/in/k-patatas](https://www.linkedin.com/in/k-patatas/)\n- **GitHub**: [github.com/Sen2pi](https://github.com/Sen2pi)\n- **Website**: [bloquinho.kpsolucoes.pt](https://bloquinho.kpsolucoes.pt/)\n- **Portfolio**: [portfoliokarimsantos.vercel.app](https://portfoliokarimsantos.vercel.app/)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\u003cstrong\u003eMade with ❤️ by the Bloquinho Team\u003c/strong\u003e\u003c/p\u003e\n  \u003cp\u003eIf Bloquinho makes a difference in your life, consider supporting independent development!\u003c/p\u003e\n\u003c/div\u003e\n","funding_links":["https://paypal.me/your-paypal-link"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsen2pi%2Fbloquinho","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsen2pi%2Fbloquinho","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsen2pi%2Fbloquinho/lists"}