As decisões já foram tomadas.
E estão escritas.
O Prumo começa um projeto TypeScript com o framework, o desenho dos módulos, as regras do banco, a ligação da autenticação e os limites de teste já escolhidos. Cada um foi decidido uma vez, escrito dentro do projeto que o recebe, e transformado em algo que roda.
npx @stjoseph/prumo new my-appUm projeto novo chega com duas coisas
- Código que já funciona
- Instalado, ligado e provado por iniciar, não por compilar. Todo template está commitado por inteiro e nenhum deles chama o scaffolder de terceiros na hora da instalação.
- As convenções que ele segue
- Uma pasta .prumo/ com as regras que esse código obedece. Qualquer assistente de IA que trabalhe no repositório a lê e passa a conhecê-las sem ninguém explicar. As convenções vivem no projeto, não na cabeça de alguém.
Quatro tipos, e do que cada um é feito
| Tipo | O que você recebe |
|---|---|
| api | NestJS, MikroORM sobre PostgreSQL, Better Auth em schema próprio, Swagger, Vitest com Testcontainers |
| web | Vite, React, TanStack Router e Query, Tailwind, shadcn/ui, formulários validados com Zod |
| mobile | Expo com Expo Router, NativeWind, MMKV, e a sessão guardada no expo-secure-store |
| site | Next no App Router, estático por padrão, para páginas que precisam ser indexadas |
Um tipo produz aquele projeto sozinho. Vários produzem um workspace pnpm, com o contrato de comunicação compartilhado, de modo que uma mudança de um lado quebra o outro no typecheck.
Nada importante é decidido pelo silêncio
Toda pergunta que o CLI faz também tem uma flag, que é como ele roda na CI sem terminal. Fora de um terminal interativo, uma resposta que falta é erro, não valor padrão.
npx @stjoseph/prumo new my-app --types api,web --single-tenantA stack está travada, e diz isso
Um documento nomeia cada pacote, cada piso de versão e as dezesseis entradas descartadas de propósito. Ele foi escrito para ser tratado como dado: um projeto gerado herda tudo aquilo, e nada volta a ser resolvido projeto a projeto.
Abrir a stack travadaPrumo Desktop
Um aplicativo de desktop que cria projetos Prumo, lista-os, lê suas convenções e roda seus apps. A fundação roda; as funcionalidades estão sendo construídas uma por vez.