create-adaptive-app

Scaffolder oficial para iniciar um projeto com Adaptive.

O starter gera apps usando os pacotes com scope:

• @adaptivejs/*

O que ele gera

Um app pronto com:

• server.ts
• src/pages
• src/components
• src/layout.ts
• src/actions
• public
• scripts dev, build e start
• netlify.toml
• scripts build:netlify e preview:netlify

O template ja mostra:

• pagina SSR simples
• pagina declarativa com compose
• hooks reativos
• client component com "client";
• server action com "server";
• chamada direta da server action a partir do componente cliente
• uso de AdaptiveFormData com arquivo

Server modules

O starter sai com src/actions/index.ts, mas isso nao e a unica opcao.

Voce tambem pode criar arquivos como:

• src/actions/users.ts
• src/features/auth/server.ts
• src/lib/newsletter.ts

Desde que o modulo esteja dentro de src e tenha "server"; no topo, um componente cliente pode importar suas funcoes direto.

Uso

npx create-adaptive-app meu-app

Depois:

cd meu-app
npm install
npm run dev

Para gerar o preset de deploy do Netlify:

npm run build:netlify

Observacao:

• o scaffolder publicado funciona com os pacotes @adaptivejs/*
• a CLI usada pelo projeto e @adaptivejs/cli

Uso local no monorepo

Para testar o starter apontando para os pacotes locais do monorepo:

node D:\projetos\Adaptive\create-adaptive-app\index.mjs meu-app --local

Nesse modo, o app gerado:

• usa file: para @adaptivejs/ft, @adaptivejs/ui e @adaptivejs/web
• chama a CLI direto de D:\projetos\Adaptive\scripts\adaptive-cli.mjs

.env

O template inclui .env.example.

Voce pode criar:

• .env
• .env.local
• .env.development
• .env.development.local
• .env.production
• .env.production.local

Somente variaveis com prefixo ADAPTIVE_PUBLIC_ vao para o bundle cliente.

Objetivo

Evitar que o usuario precise montar a estrutura manualmente.

A ideia e que o starter ja venha:

• organizado
• pronto para rodar
• usando a CLI do Adaptive
• refletindo a arquitetura atual da framework