Higgsfield Websites

Higgsfield website builder (CLI) — two product types, two flows

You drive the whole lifecycle through the Higgsfield CLI (higgsfield website …), then edit code on the local filesystem with git + bun. You are building ONE per-website Cloudflare Worker: a React 19 + TanStack Start app, server-rendered (SSR), deployed as a single Worker at the product's own subdomain. The project lives in app/ — run every bun/build command from there.

The two types — and the REQUIRED --type on create

higgsfield website create requires --type, and it is the USER'S choice — when the request doesn't make it obvious, ask the user before creating (one question, up front):

• --type website — a standalone product with NO Higgsfield integration: no "Sign in with Higgsfield", no requests to Higgsfield, no fnf SDK. Every website gets a fully independent brand: own palette, type, and chrome from a design brief, custom Tailwind/CSS only — never import @higgsfield/quanta/*. Do NOT use q-prefixed tokens anywhere on a website, and no "Powered by / Built on Higgsfield" badges or mentions in page content. The user's brand is the only brand on the page.

  higgsfield website create --type website
  

• --type app — a product tightly integrated with Higgsfield: its users Sign in with Higgsfield and generate images/videos through the fnf SDK (the full auth + D1 contract applies). An app must look and feel like a Higgsfield product: UI built with Quanta (references/quanta-design.md) + HeroUI for component gaps, starting from a standard app layout (references/app-layouts.md). Quanta and the app layouts are app-only — never applied to a --type website build. The independent-brand rule and the wow pipeline (design-taste-frontend, boards, wow catalog) are the website path; apps never get a custom brand — Quanta is the brand.

  higgsfield website create --type app
  

Quick tells: "landing page / portfolio / marketing site / SaaS with its own users" → website. "generator / AI tool / anything with Higgsfield models, credits, or generation history" → app.

Prerequisites

1. If higgsfield is not on $PATH, install it:

   curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
   

2. If higgsfield account status reports Session expired / Not authenticated, ask the user to run higgsfield auth login (interactive) and wait for confirmation.
3. git and bun are used locally once you clone the repo. The CLI itself handles create / repo / deploy / publish / status / db / secrets / delete — and the asset generation jobs (higgsfield generate …, higgsfield model …).

Pick the path, then follow ONE flow end-to-end

1. Resolve the --type (ask the user if unclear — it's their choice).
2. Read the matching flow and follow it — it is the complete workflow for that type, including its own references, hard rules, editing map, and deploy/publish gates:

Both flows share the same platform mechanics (SSR Worker, app.manifest.json infra, preview-first deploys via higgsfield website deploy … --env preview, the publish gate with the branded cover per references/app-cover.md) — each flow restates what it needs, so you never have to read the other one.

UX rules

1. Be concise. No raw website IDs, tokens, or JSON dumps in chat. After a deploy, return the preview URL (from higgsfield website status) and a one-line summary.
2. Never echo the scoped git token back to the user, and never commit it.
3. Detect the user's language from the first message and reply in it. CLI flags and code stay English.
4. Preview is the default and the only environment you deploy on your own. Deploy --env production ONLY when the user explicitly asks to publish / go live / ship.

Do NOT search the skill library for other design guidance — everything is under this skill.

Reference index (what's in this bundle)

The two flow files pull in the rest as needed — you don't read these directly unless a flow sends you there.

Both flows: references/app-cover.md (launch cover + OG image), references/runtime-and-infra.md (TanStack routes, SSR, Worker runtime), references/security.md (Worker hardening, OWASP audit, threat model).

Website flow: references/design-recipe.md, references/wow-catalog.md, references/wow-maker.md, references/reference-boards.md, references/asset-system.md, references/image-to-code.md, references/design-taste-frontend.md, references/review-rubric.md, references/seo.md.

App flow: references/quanta-design.md, references/app-layouts.md, references/heroui-fallback.md, references/brand-review.md, references/fnf-sdk.md, references/fnf-react.md, references/auth.md, references/containers.md.