PageForge AI

Transforme uma ideia em uma página pronta para vender.

Plataforma web de IA que transforma o briefing de um produto em sales pages, presells, advertoriais e páginas de conversão profissionais — escritas, desenhadas e validadas, exportáveis como HTML estático que funciona em qualquer hospedagem.

ABRIR PAGEFORGE AI → CRIAR NOVA PÁGINA → BRIEFING → TIPO → ESTILO →
GERAR COM IA → PREVIEW → EDITAR / REGERAR → EXPORTAR

A PageForge AI é o builder. Cada página gerada recebe a própria direção de arte — não a identidade verde daqui. O builder e as páginas geradas são coisas separadas: a página exportada é um arquivo independente.

---

O cérebro

O motor de geração é a Forge Sales Page Skill (neste mesmo repositório: SKILL.md, references/, scroll-experience/, templates/, scripts/). O build compila esse conhecimento em api/_lib/knowledge.generated.js, e as funções serverless o usam como sistema especialista:

• análise de oferta, avatar, mecanismo, objeções e estágio de consciência;
• arquitetura de vendas por caso (consciência × tráfego × ticket);
• copywriting de conversão no idioma do briefing;
• direção de arte única por produto + regras anti-“cara de IA”;
• SEO on-page/técnico/social + JSON-LD válido (sem Review/AggregateRating);
• compliance Google Ads e Meta Ads;
• camada de scroll: STATIC → MOTION → CINEMATIC → SCROLL STORYTELLING;
• QA e exportação (index.html + robots.txt + sitemap.xml + site.webmanifest + README-PUBLICAR.md + zip).

A skill continua utilizável de forma isolada por agentes (Claude Code, Codex) — ver SKILL.md. Os scripts de QA seguem em scripts/ (npm run skill:*).

---

Arquitetura

api/
  generate.js            POST — briefing → página completa (full ou regeneração de seção)
  health.js              GET  — estado do provider de IA (nunca vaza a chave)
  _lib/
    providers.js         AIProvider desacoplado → NVIDIA (1º provider)
    knowledge.js         curador: seleciona as fatias do cérebro por formato/modo
    knowledge.generated.js   compilado de SKILL.md + references/ + scroll-experience/
    prompt.js            monta system + user (identidade PageForge AI + contrato de saída)
    sanitize.js          normaliza/valida o briefing; preserva #aff=
    postprocess.js       extrai HTML, endurece <head>, remove schema falso, QA leve
    mock.js              gerador de exemplo (só com PAGEFORGE_MOCK=1)
    http.js              helpers das funções serverless
public/                  o builder (estático)
  index.html  assets/css  assets/js  robots.txt  sitemap.xml  site.webmanifest
scripts/
  build-knowledge.mjs    compila o cérebro (roda no build da Vercel)
  app-selftest.mjs       testes da camada PageForge AI (Node puro, offline)
  verify.js validate-links.js scroll-qa.js build.js package.js   (QA da skill)

Provider de IA — camada desacoplada. Hoje só NVIDIA (https://integrate.api.nvidia.com/v1, compatível com OpenAI). Para adicionar OpenAI / Gemini / Groq no futuro: implementar a interface chat() em api/_lib/providers.js e registrar no mapa PROVIDERS — sem tocar no resto.

---

Configuração

cp .env.example .env          # e preencha:
# NVIDIA_API_KEY=nvapi-...

Opcionais (têm default, não vão no .env.example):

Variável	Default	Uso
NVIDIA_MODEL	meta/llama-3.3-70b-instruct	trocar o modelo NVIDIA
NVIDIA_BASE_URL	https://integrate.api.nvidia.com/v1	endpoint compatível alternativo
AI_PROVIDER	nvidia	provider ativo
PAGEFORGE_MOCK	—	1 = modo exemplo sem IA (só dev)

A chave é usada apenas no servidor (funções api/). Nunca vai para o frontend, o bundle, os logs ou o Git (.env* está no .gitignore).

Se NVIDIA_API_KEY estiver ausente: o builder inteiro funciona; só a geração retorna uma mensagem clara de configuração.

---

Rodar local

npm run build            # compila o cérebro
npm test                 # testes da camada de IA (offline)

# opção A — só o front + mock (sem Vercel CLI):
PAGEFORGE_MOCK=1 npx vercel dev        # se tiver a CLI
# opção B — servir /public e apontar /api para funções da Vercel:
npx vercel dev

Deploy: Vercel (Framework: Other · Output: public · Build: node scripts/build-knowledge.mjs). Configurar NVIDIA_API_KEY em Project → Settings → Environment Variables.

---

Segurança / compliance embutidos

• Chamadas de IA server-side; segredo só no servidor; input validado e limitado; timeout de 56s; mensagens amigáveis; proteção contra chave ausente.
• Guardrails da skill sempre ativos: sem depoimento/estatística/autoridade inventada, sem promessa absoluta, disclaimers em nicho sensível, urgência só se real, Review/AggregateRating removidos do JSON-LD automaticamente.
• V1 sem banco de dados: rascunho fica em localStorage. Arquitetura pronta para adicionar persistência depois sem reconstruir o builder.

Licença

MIT (LICENSE).