Per cominciare

Tre comandi e hai un sito in locale. create-biagiojs fa il lavoro sporco; tu aggiungi pagine e pesi business.

Installazione

npx create-biagiojs mio-sito
# oppure con template:
npx create-biagiojs mio-sito --template blog

Template: default, blog, landing, shop, docs.

cd mio-sito && npm install
npm run dev

Il dev server parte su http://localhost:4321. Con vite ottieni HMR e TypeScript; altrimenti fallback integrato con rebuild incrementale, overlay CWV e weights inspector.

Primo build

npm run build

L'output finisce in dist/: HTML statico, sitemap, robots, immagini ottimizzate.

Config con IntelliSense

Crea biagio.config.js nella root:

import { defineConfig } from 'biagiojs/config';

export default defineConfig({
  site: {
    name: 'Il Mio Sito',
    baseUrl: 'https://tuosito.com',  // canonical, OG, sitemap
    description: 'Un sito costruito con biagiojs',
  },
});

Per TypeScript: biagio.config.ts (serve esbuild o vite in devDependencies).

Prima pagina

Il modo più rapido è un file .biagio in pages/:

<page title="Home" description="Benvenuto" />

<component id="hero" seo="1" conversion="0.8">
  <template>
    <section><h1>Ciao mondo</h1></section>
  </template>
</component>

Salva come pages/index.page.biagio → route /.

Oppure:

biagio new page about
biagio new page blog/[slug]

Comandi utili

Prossimi passi

• Struttura progetto
• Sintassi .biagio
• Content collections
• Pesi business
• CLI