Kit mods

Graphics kit mods are low- or no-code commands that reconfigure your project or add features to it. Each mod bundles up the several file edits a task would otherwise require, so you don’t have to make them by hand.

Run the mods command in your project and pick one from the menu:

pnpm mods

┌  Kit mods
│
◆  Which mod do you want?
│  ● Export AI statics — export JPG and EPS files
│  ○ Make an embed page — for ai2svelte graphics
│  ○ Change my project type — to embeds-only or pages+
│  ○ Convert to a graphics blog — posts feed + permalinks
└

Tip

Mods change files in your project. Run them on a clean working tree (commit or stash first) so you can review — and easily undo — what a mod changed.

Available mods

Change project type

Switch between pages+ and embeds-only.

Make an embed page

Create an embeddable page for an ai2svelte graphic.

Export AI statics

Export JPG and EPS versions of an Adobe Illustrator graphic.

Convert to a graphics blog

Turn the project into a reverse-chronological blog of posts.

Change project type

Switch your project type between pages+ (a full page that can also serve embeds) and embeds-only (just embeddable graphics, no standalone page).

The mod detects your current type and swaps to the other, rewriting your homepage, your page embed and your publisher.config.ts. It’s reversible — run it again to switch back.

Note

Switching overwrites the homepage, page embed and publisher config with the template for the target type, so any edits you’ve made to those specific files will be replaced.

Make an embed page

Make an embeddable page for an Adobe Illustrator graphic so it can be published as a media embed.

You can only run this after you’ve exported your graphic from Adobe Illustrator with ai2svelte. It reads the components in src/lib/ai2svelte/, asks which one and which language the embed is for, and creates the embed page at pages/embeds/<locale>/<slug>/.

Note

After creating the embed, add the graphic to your "embeds" ArchieML doc and export AI statics for it before publishing.

Export AI statics

Export JPG and EPS static versions of an Adobe Illustrator graphic — the formats media clients need.

Point it at an .ai file in your project-files/ directory and choose a language. It writes the EPS and JPG into media-assets/<locale>/<slug>/ and copies the JPG into src/statics/ so it’s available to your pages.

See statics for media clients for how these are used.

Convert to a graphics blog

Turn your project into a graphics blog: a single main page that lists every post in reverse-chronological order, plus a permalink page for each post so individual posts can be shared and picked up by search crawlers.

Each post is a JSON file in locales/en/ (post-1.json, post-2.json, …). Drop a new one in and it appears on the blog automatically, newest first. Posts render through src/lib/Post.svelte, which handles text and ai-graphic blocks out of the box — add more block types there as your posts need them.

When you run the mod it:

1. Scaffolds the blog pages and a placeholder first post, so the app builds and runs right away.
2. Creates two RNGS.io stories for you — one for the main page and one for the first post — and syncs their content down.

Caution

Converting to a blog is a one-way change. Once converted, the Change project type mod no longer applies.

Note

The RNGS.io step needs network access and your credentials. If it can’t finish (for example, you’re offline), the mod prints the exact commands to run later — your blog is already scaffolded and will build in the meantime.

To add more posts after converting, create another story synced to a new locales/en/post-<n>.json:

pnpm stories:new