hola

Hola é uma plataforma moderna de implantação de aplicativos para home labs, projetada para entusiastas e usuários avançados. Ela oferece uma experiência guiada para descobrir, instalar e gerenciar aplicativos self-hosted em servidores pessoais, tudo a partir de um painel web. O projeto é um monorepo TypeScript-first usando Bun workspaces, contendo uma UI web em React, uma API de servidor baseada em Bun, tipos compartilhados, um CLI, um SDK e uma pilha Docker Compose. Os recursos implementados incluem um catálogo de aplicativos com busca e detalhes, um assistente de instalação guiado com edição de variáveis de ambiente, overrides de Docker Compose, upload de arquivos de configuração/segredos, validação rigorosa e verificações de pré-voo. Controles de ciclo de vida de implantação (iniciar, parar, reiniciar, excluir, reverter), roteamento baseado em Traefik, verificações de saúde, logs ao vivo e visualizações de status também estão disponíveis. O estado persiste entre reinicializações, e a autenticação usa uma chave de API de administrador. Itens do roadmap ainda não implementados incluem notificações, backups agendados com restauração via UI e SSO de aplicativos via provedor de identidade externo. O projeto visa explicitamente ambientes locais/self-hosted, não casos de uso empresariais ou multi-tenant. A estrutura do monorepo inclui pacotes para web, servidor, compartilhado, CLI, SDK e compose. A pilha tecnológica usa Bun 1.3.14, TypeScript 6.x, Vite, React, TailwindCSS, React Router e HTTP nativo do Bun com SSE. A instalação é simples: um instalador de uma linha configura a pilha de produção (Traefik + web + servidor) em um host com Docker e Docker Compose v2. O CLI pode ser instalado separadamente e configurado para apontar para um servidor existente via variáveis de ambiente. Para desenvolvedores, o repositório fornece scripts para desenvolvimento, testes (incluindo testes de integração com Docker real), verificação de tipos, linting e build. A documentação cobre arquitetura, operações, decisões de autenticação e diretrizes de contribuição.