❓ Frequently Asked Questions

Is Bloquinho really free?

Yes! Bloquinho is 100% open source and free for everyone, forever. There are no paid plans, subscriptions or limitations.

What platforms are supported?

Bloquinho works on all major platforms:

• Desktop: Windows, macOS, Linux
• Web: Modern browsers (Chrome, Firefox, Safari, Edge)
• Mobile: Android and iOS (in development)

How can I contribute to the project?

There are several ways to contribute:

• Development: Contribute code on GitHub
• Documentation: Help improve the Wiki
• Testing: Report bugs and suggestions
• Translation: Help with translations
• Donation: Financial support for the project

How is my data stored?

Your data is stored locally on your device with advanced encryption:

• Local Storage: All data stays on your device
• Encryption: Sensitive data is encrypted with AES
• FlutterSecureStorage: Protected OAuth2 tokens
• Hive Database: Fast and reliable local storage
• No Telemetry: No data is sent without your permission

Is OAuth2 secure?

Yes! Bloquinho's OAuth2 system was designed with maximum security:

• Encrypted Tokens: Stored with FlutterSecureStorage
• Auto Renewal: Tokens are renewed automatically
• Single Login: You log in once and stay connected
• Robust Validation: Expired tokens are removed automatically
• Detailed Logs: Total transparency of operations

Can I use Bloquinho offline?

Absolutely! Bloquinho works completely offline:

• Offline Mode: All main features work without internet
• Optional Sync: Cloud is optional, not required
• Local Data: Everything is saved locally first
• Manual Backup: Total control over your backups

What are the main features?

Bloquinho offers a complete set of productivity tools:

• Notion-like Editor: Advanced editor with blocks and slash commands
• Workspaces: Multiple contexts (personal, work, studies)
• Profile System: Profiles with avatars and personal information
• Backup and Sync: Robust local and cloud backup system
• Database: Advanced tables with 17 data types
• Agenda and Events: Complete calendar management
• Password Manager: Secure credential storage

How does the workspace system work?

The workspace system allows you to organize your data by context:

• Default Workspaces: Personal, Work, Studies
• Complete Isolation: Each workspace has independent data
• Organized Sections: Notes, Documents, Passwords, Agenda, DB
• Customization: Colors, icons and custom names
• Duplication: Create copies of existing workspaces

Como funciona o cache de avatares?

O sistema de cache de avatares garante performance e privacidade:

• Download Automático: Fotos baixadas automaticamente via OAuth2
• Armazenamento Local: Pasta dedicada no dispositivo
• Controle Inteligente: Refresh automático após 1 dia
• Limpeza Automática: Arquivos antigos removidos após 7 dias
• Fallback Robusto: Iniciais quando não há foto disponível

Quais serviços de nuvem são suportados?

O Bloquinho suporta os principais serviços de nuvem:

• Google Drive: Integração completa com OAuth2
• Microsoft OneDrive: Suporte via Microsoft Graph API
• Estrutura Organizada: Pastas criadas automaticamente
• Sincronização Bidirecional: Upload e download automáticos
• Indicadores Visuais: Status de sincronização em tempo real

Como funciona a persistência de sessões?

O sistema mantém suas sessões ativas automaticamente:

• Login Único: Você faz login uma vez e permanece conectado
• Restauração Automática: Sessões são restauradas na inicialização
• Validação de Tokens: Tokens expirados são removidos automaticamente
• Debug Completo: Logs detalhados para diagnóstico
• Segurança Máxima: Tokens armazenados com criptografia

Como funciona o sistema de backup?

O sistema de backup oferece múltiplas opções de proteção:

• Backup Local: Arquivos JSON com todos os dados
• Exportação Manual: Controle total sobre backups
• Importação Segura: Restauração com validação de integridade
• Backup Automático: Criação automática com limpeza
• Estatísticas Detalhadas: Informações completas sobre backups

Como posso expandir a Wiki?

A Wiki é facilmente expansível:

• Arquivos HTML: Adicione novos arquivos na pasta /Site/wiki
• Menu Automático: O menu lateral atualiza automaticamente
• Navegação Integrada: Sistema de navegação já implementado
• Design Consistente: Use o CSS existente para manter o visual
• Animações: Efeito de virar página já implementado

Quais tecnologias são usadas?

O Bloquinho utiliza tecnologias modernas e confiáveis:

• Frontend: Flutter para interface multiplataforma
• Estado: Riverpod para gerenciamento de estado reativo
• Armazenamento: Hive para dados locais
• Segurança: FlutterSecureStorage para dados sensíveis
• Navegação: GoRouter para roteamento avançado
• OAuth2: Autenticação segura com Google e Microsoft

Como reportar bugs ou solicitar funcionalidades?

Existem várias formas de contribuir com feedback:

• GitHub Issues: Reporte bugs e sugestões no repositório
• Email: Entre em contato diretamente via email
• LinkedIn: Conecte-se com o desenvolvedor
• Documentação: Consulte os logs de desenvolvimento
• Contribuição Direta: Envie pull requests com melhorias

Como posso obter suporte?

Oferecemos múltiplos canais de suporte:

• Email: dr.karim.patatas@gmail.com
• Telefone: +351 925 542 328
• LinkedIn: https://www.linkedin.com/in/k-patatas/
• GitHub: https://github.com/Sen2pi
• Site: https://bloquinho.kpsolucoes.pt/
• Portfolio: https://portfoliokarimsantos.vercel.app/

O projeto é mantido ativamente?

Sim! O Bloquinho é um projeto ativo com desenvolvimento contínuo:

• Atualizações Regulares: Novas funcionalidades e correções
• Logs Detalhados: Documentação completa de desenvolvimento
• Testes Abrangentes: Cobertura de testes de 95%+
• Feedback da Comunidade: Melhorias baseadas em sugestões
• Roadmap Claro: Planejamento de funcionalidades futuras