Getting started

Three commands and you have a site on localhost. create-biagiojs handles the scaffolding; you add pages and business weights.

Install

npx create-biagiojs my-site
# or with a starter template:
npx create-biagiojs my-site --template blog

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

cd my-site && npm install
npm run dev

Dev server runs at http://localhost:4321. With vite in devDependencies you get HMR and TypeScript; otherwise a built-in fallback with incremental rebuild, live CWV overlay and weights inspector.

First build

npm run build

Output goes to dist/: static HTML, sitemap, robots, optimized images. Serve from any CDN.

Config with IntelliSense

Create biagio.config.js at the project root:

import { defineConfig } from 'biagiojs/config';

export default defineConfig({
  site: {
    name: 'My Site',
    baseUrl: 'https://yoursite.com',  // feeds canonical, OG, sitemap
    description: 'A site built with biagiojs',
  },
});

For TypeScript: biagio.config.ts (requires esbuild or vite in devDependencies).

First page

The fastest path is a .biagio file in pages/:

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

<component id="hero" seo="1" conversion="0.8">
  <template>
    <section><h1>Hello world</h1></section>
  </template>
</component>

Save as pages/index.page.biagio → route /.

Or scaffold:

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

Useful commands

Next steps

• Project structure
• .biagio syntax
• Content collections
• Business weights
• CLI reference