Dartisan — pub.dev self-hosted

🚧 Em desenvolvimento. O núcleo do protocolo pub (metadados, download, publicação), autenticação (usuário/senha e GitHub OAuth), frontend web e publicação a partir de repositórios privados do GitHub já estão implementados — falta o fallback para o pub.dev oficial (ver roadmap abaixo). Não use em produção ainda. Veja o CHANGELOG pra acompanhar o que foi feito.

O que é

Um servidor de repositório de pacotes Dart/Flutter self-hosted e open source, compatível com o protocolo do pub (o mesmo usado pelo dart pub / flutter pub). A ideia é permitir que times e comunidades hospedem seu próprio índice de pacotes — públicos ou privados — sem depender de um serviço de terceiros pago, com todo o código (servidor incluído) aberto.

Motivação

O ecossistema Dart/Flutter já tem soluções de repositório próprio, mas cada uma cobre uma parte do problema:

• PubNet — servidor em C#/.NET com frontend Blazor, suporte a fallback pro pub.dev oficial. Código aberto, mas fora do ecossistema Dart.
• unpub — servidor em Dart puro, arquitetura extensível (MetaStore/PackageStore plugáveis), mas com manutenção mais lenta.
• OnePub — repositório privado de pacotes bem estabelecido, porém o servidor é fechado (SaaS pago); apenas o CLI cliente é open source (GPL v2).

Não existe hoje uma opção 100% aberta, com servidor incluso, mantida pela comunidade Dart/Flutter e fácil de hospedar. É essa lacuna que este projeto busca preencher.

Objetivo

Produto open source, feito para a comunidade, cobrindo o fluxo essencial do protocolo pub:

• Consulta de metadados de pacotes e versões
• Download de tarballs de pacotes
• Publicação de novas versões (dart pub publish / flutter pub publish)
• Fallback automático para o pub.dev oficial para pacotes que não existem localmente

Arquitetura (visão geral)

Camada	Tecnologia
Backend	Vaden (framework Dart inspirado em Spring Boot)
Banco de dados	PostgreSQL, via Drift como ORM/query builder
Frontend	Flutter (Web)
Autenticação	JWT (access + refresh token), roles (admin, publisher, reader), tokens dedicados para publicação via CLI, login via GitHub OAuth

Dependências de referência reaproveitáveis

• pubspec_manager (MIT) — leitura/escrita de pubspec.yaml preservando comentários
• pub_semver — resolução de versões semver, usado pelo próprio time do Dart

Projetos de referência (links)

• PubNet: https://github.com/ricardoboss/PubNet
• unpub: https://github.com/pd4d10/unpub
• OnePub (CLI): https://github.com/onepub-dev/onepub
• Vaden (framework backend): https://github.com/Flutterando/vaden

Roadmap inicial

• Endpoint de metadados de pacote (GET /api/packages/{name})
• Download de tarball de versão
• Fluxo de publicação (POST /api/packages/versions/new)
• Fallback para pub.dev oficial
• Autenticação (JWT + roles)
• Frontend Flutter Web (busca, página de pacote, painel de tokens)

Além do roadmap inicial

Funcionalidades que foram além do escopo original dos 6 itens acima — detalhes em cada entrada do CHANGELOG:

• Login via GitHub OAuth, com criação automática de conta (role reader por padrão)
• Publicar pacotes a partir de repositórios privados do GitHub, sem precisar do dart pub publish via CLI — conecta a conta, escolhe repositório/branch/tag, importa e publica
• Curtidas e contagem de downloads (com sparkline dos últimos 30 dias) por pacote
• Design system próprio (paleta "oficina de latão", tipografia, logo) no lugar do visual genérico inicial

Licença

MIT — em linha com o restante do ecossistema Dart/Flutter (incluindo dependências de referência como pubspec_manager) e sem incompatibilidade com dependências sob GPL.

Como contribuir

O fluxo essencial do protocolo pub (metadados, download, publicação), autenticação e o frontend web já estão funcionais, mas o projeto ainda não está aceitando contribuições externas por enquanto. Guidelines de contribuição, setup local e como rodar os testes serão publicados em breve.