mirror of
https://github.com/hanzo-apps/folio-contact.git
synced 2026-11-09 15:48:25 +00:00
4.1 KiB
4.1 KiB
LLM.md — Hanzo Agent Build Playbook for Folio Contact (folio-contact)
Agent Directive: Read this file before modifying any code. This repository is a Hanzo Cloud-optimized seed template (
https://github.com/hanzo-apps/folio-contact). Use the Hotspot File Map, Parameterization Contract, andsrc/lib/hanzo.tsSDK below to customize and ship the user's application in minimal turns with zero broken builds.
1. Template Identity & Stack
- Template Seed:
folio-contact(Folio Contact) - Target Brand / Project:
Folio Contact(folio-contact.hanzo.app) - Category & Use Case: Folio Portfolio — Contact pages
- Framework: HTML/Gulp
- Build Output Directory:
build - Live Reference Preview: https://gallery.hanzo.ai/previews/folio-contact/index.html
- Edit in Hanzo Studio: https://hanzo.ai/chat?template=folio-contact
2. Exact Hotspot File Map ("Where to Edit What")
- Brand Copy, Catalog & Domain Data (EDIT FIRST):
src/data/src/constants/index.html
- Primary UI Sections & Interactive Views:
src/components/src/pages/src/App.tsx
- Design Tokens, Typography & Theme Variables:
src/styles/index.css
- Engine / Shaders / Core Runtime (DO NOT BREAK):
vite.config.tspackage.json
3. Active Composable Blocks
project-showcase-gridcase-study-detailabout-biocontact-formcontactformcommunication
4. Parameterization Contract (.env.local & hanzo.template.json)
| Parameter | Env Variable | Default / Value | Purpose |
|---|---|---|---|
brandName |
VITE_SITE_NAME |
Folio Contact |
Primary brand or product title rendered in navigation and metadata |
tagline |
VITE_SITE_TAGLINE |
Contact pages |
Headline or value proposition displayed in the hero section |
hanzoApiKey |
HANZO_API_KEY |
hz_live_your_api_key |
API key for Zen AI models, embeddings, and agents via https://api.hanzo.ai/v1 |
hanzoAiModel |
VITE_HANZO_AI_MODEL |
zen4 |
Default Hanzo AI model routed for chat, copilot, and structured completions |
hanzoAnalyticsId |
VITE_HANZO_ANALYTICS_ID |
hz_ins_folio-contact |
Project telemetry key for real-time pageviews, conversion funnels & AI token insights |
hanzoIamOrg |
VITE_HANZO_IAM_ORG |
hanzo |
Organization tenant slug on hanzo.id for zero-config SSO and RBAC |
accentColor |
VITE_ACCENT_COLOR |
#ffffff |
Primary interactive accent token (hex or CSS color) |
themeMode |
VITE_THEME_MODE |
dark |
Initial color scheme applied on first visit |
5. Pre-Wired Hanzo Cloud Stack (src/lib/hanzo.ts)
Every Hanzo template integrates out of the box with the Hanzo Cloud stack via src/lib/hanzo.ts:
- Zen AI Gateway (
https://api.hanzo.ai/v1):- Call
askHanzoAi(prompt, { model: 'zen4', system })for chat, copilot, command palette, or structured generation. - Uses
HANZO_API_KEY(provision at https://console.hanzo.ai/keys).
- Call
- Hanzo Analytics & Insights (
https://analytics.hanzo.ai/v1/track):- Call
trackInsight(event, properties)on key user actions (CTA clicks, checkout, prompt submissions, onboarding steps). - Uses
hz_ins_folio-contactand automatically logs AI latency + token usage.
- Call
- Hanzo IAM Single Sign-On (
https://hanzo.id):- Organization tenant:
hanzo.
- Organization tenant:
6. Agent Execution Playbook (4 Deterministic Steps)
- Configure Parameters: Update
hanzo.template.jsonand.env.localwith the user's brand name, tagline, accent tokens,HANZO_API_KEY, andHANZO_ANALYTICS_ID. - Update Hotspot Data & Copy: Edit the files listed under Brand Copy, Catalog & Domain Data first. Prefer structured data edits over rewriting layout trees.
- Wire Cloud AI & Insights: Import
askHanzoAiandtrackInsightfromsrc/lib/hanzo.tsinto interactive components (command bars, forms, AI assistants, primary CTAs). - Verify & Deploy: Run
npx gulp buildto verify zero TypeScript or bundler errors, then deploy withnpx @hanzo/cli deploy --template folio-contact --name folio-contact --platform --insights.