Perguntas frequentes

Perguntas, respondidas

O que mais nos perguntam sobre o Indigo — licenciamento, como se compara com construtores e boilerplates, e como é construir sobre ele.

Licenciamento e custo

É gratuito? Qual é o senão?

O Indigo é mesmo gratuito?

Sim. A framework e quase todos os módulos são gratuitos e open source sob a licença permissiva Apache-2.0. Pode construir, operar e lançar com eles sem custo algum — incluindo produtos comerciais de código fechado.

Posso usar o Indigo comercialmente?

Sem dúvida, e sem compromissos. A Apache-2.0 não tem obrigação de copyleft, por isso pode construir software proprietário de código fechado sobre o núcleo gratuito sem comprar nada. O código que gera é seu.

Que módulos custam dinheiro?

Apenas três. core-store (e-commerce), core-chat (chat de personagens com IA) e core-ai-writer (geração de conteúdo com IA) têm licença comercial — as verticais onde está claramente a operar um produto que gera receita. Todo o resto é gratuito.

O que cobre a licença comercial?

Apenas esses três módulos premium. Comprar uma licença permite-lhe instalá-los e implementá-los; financia o desenvolvimento contínuo do núcleo gratuito e open-source.

Como se compara

Isto é mais um construtor de sites?

Em que é que o Indigo é diferente do Wix, do Lovable, do Bolt ou do v0?

Esses são plataformas alojadas — a sua aplicação vive na infraestrutura deles, construída com as ferramentas deles, cobrada pela subscrição deles. O Indigo é o oposto: uma base de código Next.js real e open-source na sua máquina, no seu repositório git, sobre a qual o seu próprio agente de programação constrói. Não há plataforma, não há nada de onde exportar e não há precipício quando o protótipo precisa de se tornar um produto.

Em que é diferente do ShipFast ou do create-t3-app?

Um boilerplate entrega-lhe uma fotografia de código já ligado — herda a cola, mantém-na para sempre, e ela não diz nada ao seu agente. O Indigo é uma framework: as novas funcionalidades registam-se através de configuração e módulos, o núcleo partilhado nunca é editado, e o agente recebe um mapa (CLAUDE.md, diagramas ao vivo), um sinal (tipos, testes, indigo doctor) e mãos (personas MCP) para verificar o que construiu.

Construir com o Indigo

Como é trabalhar com ele?

Está pronto para produção?

O Indigo traz as preocupações de produção que a maioria dos starters salta — auth, RBAC, faturação, tempo real, trabalhos em segundo plano, i18n, SEO e um modelo escalável de papéis de servidor. Foi construído para operar produtos reais, não só demos.

Preciso de perceber a base de código inteira?

Não — pode nunca chegar a ler a maior parte dela. O Indigo é orientado por configuração e open-closed: o seu agente estende-o exatamente onde o sistema espera ser estendido, e cada alteração fica um diff pequeno e revisível.

O que significa 'agent-native'?

O agente é a interface principal. Tem um mapa (CLAUDE.md aninhados, diagramas de arquitetura ao vivo), um sinal de feedback (tipos estritos, testes, indigo doctor) e mãos na aplicação em execução (ferramentas MCP tipadas, personas de teste). Você descreve o produto; o agente constrói-o, verifica-o e pergunta-lhe no chat quando a decisão é sua.

Posso adicionar e remover módulos mais tarde?

Sim. Os módulos são git subtrees autocontidos. bun run indigo add <module> instala um — routers, schema, seeds e páginas de administração incluídos — e remove volta a tirá-lo.

Como começo?

Dê ao seu agente uma frase: claude "Set up a new project named my-app from https://github.com/indigo-fw/starter — ask me what you need". Ele cria a pasta, instala tudo e pergunta as suas escolhas no chat. Funciona da mesma forma no Codex e no Gemini CLI — e o caminho clássico degit + bun run init continua lá para quem prefere o terminal.

Preciso especificamente do Claude?

Não. O Indigo é agnóstico quanto ao agente: Claude Code, Codex CLI e Gemini CLI funcionam todos, e os mecanismos são standards abertos — ficheiros de contexto CLAUDE.md/AGENTS.md, um endpoint MCP, CLIs não interativas. Qualquer agente de programação capaz de executar comandos consegue correr o ciclo. Também pode dispensar os agentes por completo e desenvolver à mão.

E se o agente partir alguma coisa?

O ambiente foi construído para que nada se parta em silêncio. TypeScript estrito, inputs restringidos por Zod e verificações de propriedade rejeitam alterações más; o indigo doctor e os testes avaliam cada passagem; o núcleo partilhado nunca é editado, por isso o raio de impacto fica dentro da alteração. E cada passagem aterra como um simples diff de git — reveja-o, ou reverta-o.

Como chegam as atualizações da framework ao meu projeto?

O núcleo e os módulos vivem no seu repositório como git subtrees, e as suas funcionalidades estendem-nos através de configuração e registo em vez de os editar — por isso as atualizações entram limpas, sem colidir com o que construiu. Sem migrações forçadas, sem plataforma a decidir por si: faz pull quando quiser.

Onde encontro ajuda?

GitHub Discussions para perguntas, GitHub Issues para bugs, e a documentação para guias. Para suporte comercial, fale com a equipa.

Ainda com curiosidade?

A forma mais rápida de perceber o Indigo é usá-lo — a demo ao vivo corre todos os módulos.