flowral.docs
Início/Colaboração

Flowral Linux 🌸

Uma distribuição Linux independente em experiência, baseada em Void Linux (glibc) e no compositor Wayland Swirl, com um desktop que parece papel: simples, discreto, leve e feito para criar.

Site de documentação: floral.raillen.com (GitHub Pages — o domínio depende da configuração DNS).

Estado: documentação de arquitetura / pré-implementação. A v1.0 é meta futura, não uma release disponível. Alvo primário: Lenovo ThinkPad Edge E430. Idioma dos documentos: pt-BR.

Identidade

Flowral Linux combina flow (fluxo de trabalho e scrolling tiling) com o universo floral. A identidade do sistema nasce de três famílias de temas — Sakura, Daisy e Petunia — cada uma em Light e Dark, com superfícies de papel, bordas finas, destaques contidos e tipografia legível.

O Flowral não é ainda uma ISO funcional. O desenvolvimento adotará Slint Live Preview + MCP, QEMU/KVM + libvirt e automação com just, seguindo os critérios em ambiente de desenvolvimento. Um futuro Flowral DE substituirá gradualmente apenas componentes gráficos pequenos, sem reescrever compositor nem serviços críticos. Os documentos abaixo registram decisões confirmadas, hipóteses a validar, riscos técnicos e entregáveis para implementação incremental.

Decisões confirmadas

  • Void Linux x86_64 glibc, XBPS, runit; sistema modular.
  • Swirl (derivado de Scroll/Sway) com scrolling tiling e floating; janelas sem barras de título/botões do compositor, mas com bordas finas de foco; CSDs de aplicativos exigem tratamento individual.
  • WezTerm + Fish (autosuggestion, completions e abbreviations lógicas), Neovim enxuto (Tree-sitter, completion sem LSP obrigatório, Markdown enriquecido), PCManFM personalizado.
  • Aplicativos próprios em Rust + Slint: motor/aplicador de temas e Central de Controle; arquitetura em crates, sem daemon permanente para temas.
  • Configurações de Wi-Fi, Bluetooth, áudio, monitores, energia, temas, fontes, ícones, pacotes, MCPs, providers personalizados e painel de agentes com ACP.
  • OpenCode V2+ exclusivamente como alvo de configuração (não confundir com o versionamento do ACP). O agente é iniciado sob demanda.
  • Conjunto de agentes CLI/TUI e aplicativos gráficos descrito em Catálogo de software.
  • Meta experimental de até 300 MiB de RAM em repouso na sessão utilizável, não promessa já comprovada.

Índice

Área Documento
Visão, objetivos e limites Visão do produto
Decisões e pendências Registro de decisões
Arquitetura e fronteiras Arquitetura
Visual e acessibilidade Design system
Referências das imagens Capturas visuais
Temas Light/Dark e integração Motor de temas
Painéis e experiência de uso Shell visual
Componentes futuros do ambiente Flowral DE
Configurações do sistema Central de Controle
Comandos, shell e Neovim CLI/TUI
Agentes, MCPs e providers Agentes e OpenCode V2
Regras de segurança MCP MCP Manager
Provedores e modelos próprios Providers personalizados
Apps e ferramentas Catálogo de software
Alvo físico e drivers ThinkPad Edge E430
ISO e instalação Build e instalador
Memória e performance Critérios de performance
Privacidade, segurança, atualizações Segurança
Plano de entregas por versão Roadmap v0.x → v1 → v2
Como contribuir e regras de agentes Contribuição e AGENTS.md
Primeira implementação Primeiro sprint
Ambiente de desenvolvimento Toolchain
Preview para code agents Live Preview
Testes com evidências Fluxo do agente
Workforce, skills e agentes Curadoria do Prumo para Flowral
Validação e lançamento Checklist de lançamento
Terminais e arquivos próprios Estudos futuros

Organização prevista

flowral-linux/
├── docs/                   # especificações, ADRs e validação
├── crates/                 # lógica Rust compartilhada (futuro)
├── apps/                   # interfaces Rust + Slint (futuro)
├── shell/                  # painéis Wayland, launcher (futuro)
├── themes/                 # tokens, assets e adaptadores (futuro)
├── packages/               # templates XBPS (futuro)
├── distro/                 # void-mklive, Calamares e serviços (futuro)
└── tests/                  # hardware e benchmarks (futuro)

Regras inegociáveis

  1. Primeiro funcional, depois bonito: rede, entrada, sessões, armazenamento, áudio e atualização devem funcionar antes de remover alternativas seguras.
  2. Sob demanda: instalar uma ferramenta não significa executá-la no boot.
  3. Sem root para GUI: ações privilegiadas via helper estreito, validado e autenticado; nunca executar a Central de Controle inteira como root.
  4. Sem segredos em Git, temas ou logs: credenciais de providers/MCPs ficam em armazenamento protegido.
  5. Compatibilidade verificada: não inventar opções de configuração do Swirl, APIs ou dependências; detectar versões e testar no hardware real.
  6. Acessibilidade: teclado, foco visível, contraste, escalabilidade e movimento reduzido desde a primeira versão.
  7. Documentação é fonte de verdade: alterar decisão aprovada → atualizar decisões e documentos afetados no mesmo PR.

Referências primárias

Nota sobre licença: licença do código do Flowral ainda precisa ser escolhida. Preservar licenças de terceiros e revisar obrigações da licença escolhida para Slint e dos softwares distribuídos.