---
name: build-shortfolk
description: Build or remix a personal URL shortener on Spacefast from the Shortfolk starter, with a simple public page, AI-managed redirects, and AI-readable traffic data.
---

# Build your own Shortfolk

Read [the build recipe](references/build.txt) before implementation. Copy `assets/template/` into a new working directory. It contains native Zero source and editable artwork, with no original deployment binding, link records or visitor data.

If reading this skill on the web, download [the complete package](https://sflk.me/downloads/build-shortfolk.zip) and extract its build-shortfolk folder first. A plain web read does not install the skill. Agents without skill installation can follow the recipe directly and download [the starter source](https://sflk.me/downloads/shortfolk-starter.zip).

Read [AI discovery and artwork guidance](references/discovery.txt) when publishing or remixing the public learning flow. Visitors share the site link and talk with their own AI; no copy-and-paste prompt. Bake illustration labels and hero headlines/descriptions into Imagegen artwork, with separate legible phone compositions and matching semantic page text. Keep actual navigation outside the images. Shortfolk intentionally has no Text view button. Keep matching semantic headings and copy for assistive technology and public plain-text build guides; independently evaluate text resizing in your own version.

Adapt the name, copy, colors and artwork to the user's identity. `shared/identity.ts` centralizes those choices. The hero images contain the visible brand and copy: changing identity text updates semantic text and metadata, but does not reletter a raster. Regenerate both hero compositions for the new identity and configure their art paths before publishing. Keep articleUrl empty until an actual article is supplied. Shortfolk has no separate bottom hosting banner. Preserve the ordinary footer credit over the artwork.

Use the user's existing Spacefast connection to resolve their own destination and permissions. This skill does not grant permission to change the original Shortfolk, buy a domain, expose private data, or bypass a provider approval. Never carry another owner's Space ID, credential, native redirects or visitor records into a clone.

Preserve native browser-rendered Zero pages (`"use client";` and default page export), the version-pinned dependencies and native compiler. Check the current installed CLI and provider contracts before following version-sensitive examples. Inspect actual desktop/mobile rendering and controls before the user-authorized release. Verify the live page, assets, public access and metadata afterward; a ready version may not be activated.

Default links are native Spacefast redirect rules, with no link database or application link API. Create → read saved settings → verify HTTP status and Location. The formatted planner supports root aliases,301/302 and local QR SVGs; the deploy guard captures and verifies links around every release. Optional durable request counting is opt-in and disabled by default.

For links and counts, read [the owner connection guide](references/links-and-tracking.txt). Links live in private Space settings, outside the public template. Always preserve the complete settings overlay and use its observed settingsDigest for compare-and-swap. Verify the exact public redirect before returning a usable link. Read analytics/logs through the authenticated connection and return aggregates, never private client identifiers.

Deliver the user's working URL, an editable source folder, and factual verification results. If a capability is blocked or unverified, state its actual status. A new source download is a starting point, not an installed connection or a working deployment.

### Modular artwork
Keep logo, baked headline/copy, starfield background and scene as separate image assets. HeroArt in client/hero-art.tsx controls their paths and layout. Generate lettering in the image, never overlay HTML lettering. Keep matching semantic copy and public text guides. Encode responsive AVIF scenes with WebP fallback, declare actual dimensions and cache versioned public assets immutably. Re-measure performance before publishing.
