capturauptask.dev
Uptask — executor de tarefas em TypeScript
Executor de tarefas em TypeScript que transforma funções exportadas em comandos de CLI sem código repetitivo.
mantemos
Prática de engenharia
Ferramentas de desenvolvimento e publicação
Uma só cadeia de ferramentas em todos os repositórios, para que mudar entre eles não custe nada.
- pnpm
- vite-plus
- tsgo
- lefthook
- uptask
- fireargs
- livemark
O que é
A camada que ninguém demonstra: gestão de pacotes, formatação, linting, verificação de tipos, hooks de git, e como uma alteração se torna uma versão publicada.
Porque o escolhemos
Todos os repositórios que mantemos usam a mesma base — pnpm workspaces, vite-plus para formatação, linting e testes numa só ferramenta, tsgo para verificação de tipos rápida o suficiente para correr constantemente, e lefthook para a impor antes de um commit ou de um push. A uniformidade é precisamente o objetivo: mudar de projeto não custa nada, e a CI corre aquilo que quem programa já correu localmente. Onde encontrámos uma lacuna, preenchemo-la e publicámos o resultado — o uptask transforma funções exportadas em comandos de linha de comandos, o fireargs constrói ferramentas de linha de comandos a partir de esquemas, o livemark transforma Markdown em sites de documentação. Os três são usados nos nossos próprios repositórios antes de serem recomendados a alguém.
Onde o usamos
Em todos os repositórios, de clientes e internos — e nas ferramentas open source que daí publicamos.
capturafireargs.dev
Fireargs — construtor de CLI a partir do esquema
Construtor de CLIs schema-first que gera comandos componíveis com entrada e saída JSON a partir de esquemas Zod.
mantemos
capturalivemark.dev
Livemark — sites de documentação a partir de Markdown
Transforma ficheiros Markdown num site de documentação rápido — realce de sintaxe, diagramas, componentes, blogue e changelog incluídos.
mantemos
capturatestdocs.dev
Testdocs — exemplos de documentação executáveis
Extrai blocos de código TypeScript de ficheiros Markdown e executa-os como testes, mantendo os exemplos sincronizados com o código.
mantemos
Entre em contacto
Diga-nos o que precisa de construir.
Somos uma equipa pequena em Portugal, a trabalhar no horário de Londres. Um site, uma aplicação, uma ferramenta interna, ou a plataforma por trás deles — comece por uma frase sobre o problema e nós tratamos do resto.