Quickstart

Install

Until the npm registry release is verified, install the GitHub release candidate:

npm install github:HH-Studio/Sajtbuilder-SDK#main

Create a package

npx site-kit init ./my-site --template nextjs

Use --template html for a static HTML source. Both produce the same structured SnabbSajt format.

The generated directory contains:

my-site/
  site.json
  assets/
  fonts/
  README.md

Replace the starter business facts, page list, sections, and copy with real content from the source site. Do not invent facts or testimonials.

Validate

npx site-kit validate ./my-site

Errors block packing. Warnings describe safe importer coercions or suspicious content that deserves review.

Pack

npx site-kit pack ./my-site -o my-site.zip

The zip contains site.json, manifest.json, and every declared image/font. The manifest records a SHA-256 checksum for each blob.

Import

In SnabbSajt, open Settings > Backup & move, select import, and choose the zip. The result is a new draft website. Review every page on desktop and mobile before publishing.

Update an already-imported site

Set a stable externalKey on every page and section from the start. Later you can pack only the changed pages (site-kit pack ./my-site --page home) and merge the partial bundle into the existing site instead of creating a new one: matched sections update, new keys insert, sections the owner edited in the app are skipped as conflicts, and nothing is deleted. See the import report for the merge outcomes.

No API key is required for any Site Kit command.

After both npm packages are public, the recommended one-line agent setup is:

npx @snabbsajt/cli@0.2.0 skills install --agent auto