Requisitos

  • Node 24.x.
  • npm 11.x.

Execução local

O comando sobe a aplicação e a documentação Mintlify em paralelo. Quando as duas superfícies ficam disponíveis, o navegador abre duas abas automaticamente. URLs padrão: Se alguma porta estiver ocupada, o terminal mostra a porta real usada. Para manter os servidores sem abrir o navegador:
Portas explícitas:
Se a porta estiver ocupada, o script usa a próxima porta livre e imprime a URL correta. Variáveis aceitas: Build:
Gate completo:
Validação de links e navegação da documentação:

Documentação

A documentação Mintlify fica isolada em docs/. Ela reúne:
  • visão geral da entrega;
  • estrutura de pastas e rotas;
  • modelos de adoção entre Site, páginas de produto, fluxos e backend;
  • Design System, tema e componentes;
  • formulários, máscaras e autofill de demonstração;
  • dados demonstrativos que devem ser substituídos por API;
  • assets, banners e otimização;
  • fluxos por produto, Área Logada e edge cases;
  • regras de white label para logos, cores e banners.
Para abrir somente a documentação:
O comando executa mint dev dentro da pasta docs. Para abrir somente a aplicação:
Porta explícita:
A documentação não entra no bundle da aplicação. Ela é uma camada de leitura técnica para handoff.

Tenant, origem e integração

Em ambiente local, host desconhecido e acesso padrão, o Site mostra a marca pública FORT. Em um domínio ou subdomínio reconhecido, ele resolve uma configuração pública de tenant com marca, banners e produtos habilitados. Essa configuração é de apresentação e não autoriza uma operação. Ao iniciar uma jornada, o Site encaminha tenantId, partnerId, sourceDomain e selectedProductId como contexto público. O backend compara a origem com o host observado, valida a allowlist e resolve os dados operacionais FortCard. Consulte entrada e identificação do parceiro antes de configurar um novo domínio. Para conectar dados reais, mantenha as telas e rotas e substitua as fontes demonstrativas por adaptadores do backend. Os passos e os pontos removíveis estão em dados demonstrativos e autofill.