Primeiros passos
Do download à execução, adição de módulos, configurações, conexão com um backend real, design e atualizações - tudo o que você precisa no primeiro dia.
Compre a edição de que você precisa na página de preços, pelo PayPal. É uma compra única, não uma assinatura.
Minha conta no header → Meus produtos. Os zips de React, Vue e Next.js trazem a pasta da edição e o backend simulado compartilhado (initfn-mock) lado a lado.
initfn-react-1.0.0/
initfn-react/ # React edition
initfn-mock/ # mock backend (found at ../initfn-mock - keep both side by side)Node.js 24 (veja o .nvmrc de cada edição) e npm. Não é necessário para o Vanilla.
Inicie o backend simulado e depois o app. Entre com admin / 1234.
cd initfn-mock && npm i && cd ..
cd initfn-react && npm i # initfn-vue for Vue
npm run mock # mock backend http://localhost:4000
npm run dev # React :4001 · Vue :4003 · docs at /docInicie só o servidor Next (monólito) ou conecte-o ao backend simulado.
cd initfn-nextjs && npm i
npm run mock # when using the mock backend
npm run dev # http://localhost:4002 · docs at /docSem build. Abra os arquivos HTML da pasta _guide no navegador para ver o uso e o código de exemplo, depois linke as pastas css, js e font nas suas páginas.
As edições React, Vue e Next.js adicionam ou removem qualquer um dos 50 módulos com um comando - telas, APIs e menus entram e saem juntos.
npm run preset # list modules
npm run preset add social-login mfa # add
npm run preset remove mfa # removeAs edições React, Vue e Next.js dividem as configurações em três arquivos. .env guarda valores comuns a desenvolvimento e produção (nada secreto, como o nome do site), .env.development é só para desenvolvimento e .env.production só para produção. Nenhum deles vai para o git, e valores que valem só na sua máquina ficam em .env.local.
.env # shared, not secret - site name, public IDs
.env.development # dev only - local backend URL, sandbox keys
.env.production # production only - live URL, live keys, analytics ID
.env.local # your machine only (overrides the others)Ao adicionar um módulo, as chaves de configuração que ele precisa entram no fim do arquivo certo com um comentário explicando cada uma, e no final aparece a lista das chaves que faltam preencher. Valores que você já tem nunca são alterados, e remover o módulo não os apaga.
npm run preset add paypal
# -> adds PAYPAL_* keys to .env.development
# and .env.production, then lists keys to fillO endereço do backend é uma linha na tabela de core/config/apiConfig.js e uma linha em .env.development (.env.production em produção). O código das telas não muda.
# .env.development (production: .env.production)
BACKEND_API_URL=http://your-backend:8080initfn-mock/openapi.yaml descreve a API que o frontend espera. Passe para os devs de backend - um backend que responda assim se conecta sem mudar código.
Os estilos ficam em três camadas. Valores como cores, fontes, cantos e sombras vão em initfn-token.css, o visual de UI pequena como botões, campos, cards e blocos em initfn-base.css, e designs maiores como páginas e seções em initfn-global.css. Para trocar só a cor da marca, altere apenas --color-brand-* no fim do arquivo de tokens.
src/core/style/ # Vanilla: css/ · font/ · image/
css/initfn-token.css # values - colors, fonts, radius, shadows
css/initfn-base.css # small UI, components, blocks
css/initfn-global.css # pages and sections
font/ image/Passe um layout ou o estilo que você quer e peça para ela ler a skill de design incluída na sua edição antes de mudar. A skill define qual arquivo alterar em cada tipo de pedido, então a IA mexe nesses três arquivos e deixa o código das telas como está.
.claude/skills/ssr-design/ # Next.js
.claude/skills/csr-design/ # React
.claude/skills/vue-design/ # Vue
.claude/skills/vanilla-design/ # VanillaO CSS é escrito com uma regra por linha (só o arquivo de tokens quebra linhas), e o VS Code organiza sozinho ao salvar. As fontes carregam só os pedaços do Pretendard de que a tela precisa, e as fontes da primeira tela ficam em cerca de 1MB. Nas edições React, Vue e Next.js, o componente Image comum carrega imagens sob demanda e as entrega leves em avif/webp.
npm run format # tidy CSS - one rule per line
node scripts/format-css.mjs # VanillaNas edições React, Vue e Next.js, copie a pasta .preset do novo zip por cima da .preset do seu projeto e rode update. Na lista, ⬆ marca módulos instalados com nova versão e 🆕 marca módulos novos. Arquivos que você alterou nunca são sobrescritos - a nova versão fica ao lado como .preset-new, então compare, junte e depois apague.
# 1. copy .preset from the new zip over your project's .preset
npm run preset # 2. list - ⬆ update available · 🆕 new module
npm run preset update # 3. update installed modules
npm run preset add <name> # 4. add a new module
npm run lint && npm test && npm run buildQuais módulos você adicionou, e em qual versão, fica registrado em preset.lock.json na raiz do projeto. Ele fica fora da pasta .preset para que o registro sobreviva quando você sobrescreve essa pasta - faça commit dele no git também.
Para receber também as melhorias do código base, como core e shared, crie um repositório git a partir do zip e mantenha o original intacto num branch initfn. Faça seu trabalho no main.
git init && git add . && git commit -m "initfn 1.0.0"
git branch initfn # untouched originalBaixe o novo zip, sobrescreva o branch initfn, faça merge no main e rode npm run preset update para alinhar os módulos instalados. Só os pontos que você mesmo alterou aparecem como conflito. Veja nas notas de versão o que mudou.
git switch initfn
# unzip the new version over it (keep node_modules and your .env files)
git add -A && git commit -m "initfn 1.1.0"
git switch main && git merge initfn
npm run preset update # sync installed modulesTodas as edições têm os mesmos nomes de comando.
npm run lint && npm test # rules and unit tests
npm run build # production build
npm run test:e2e # browser E2EO deploy está no guia do desenvolvedor dentro do app (/doc). Ao fazer deploy ou entregar um Produto Final, inclua o THIRD_PARTY_NOTICES.md (avisos de código aberto) da edição.
O guia completo e detalhado vem dentro do arquivo do projeto. Esta página cobre só o que você precisa no primeiro dia. Todo o resto - instalação, configurações, componentes, módulos e deploy - está no arquivo baixado: o site de guia embutido (7 idiomas), o README e os docs para ferramentas de código com IA (AGENTS.md).
Veja o FAQ e a licença, ou fale com a gente em numerxlab@gmail.com.