Neus Landing Generic
產生一個一般用途的著陸頁,包含英雄區塊、內容區塊和行動呼籲。會根據使用者的目的進行調整。
重要:不使用 AppTemplate。公開頁面。
開始之前
下方的「共享規則」區塊永遠有效。此外,請在「階段 0」之前閱讀以下所有內容:
.agents/skills/_shared/anti-slop.md— 強制性品質規則(「行銷頁面」章節).agents/skills/_shared/prop-constraints.md— 禁止的 props 和不存在的元件.agents/skills/_shared/component-catalog.md— Button、Card、Link、Input 章節.agents/skills/_shared/design-personality.md— 個性軸線、VISUAL DIRECTIVE 格式、第 9 節深色模式表面食譜.agents/skills/_shared/dark-surfaces.md— 深色模式 CSS 食譜(模式為 dark 時閱讀).agents/skills/_shared/light-surfaces.md— 淺色模式 CSS 食譜(模式為 light 時閱讀).agents/skills/_shared/checklist.md— P0/P1/P2 關卡.agents/skills/_shared/layout-patterns.md— 登陸頁模式(統計行、區塊標題分割、英雄區塊眉毛藥丸、模式自適應導航).agents/skills/neus-landing-generic/references/dark-landing-patterns.md— 深色主題登陸頁的區塊版面解剖和 JSX 模式
階段 0 — 收集資料
在繼續之前,向使用者詢問這些問題,並等待他們完整回覆:
- 這是什麼類型的頁面?(作品集、公司、活動、代理商、部落格、個人、其他)
- 頁面名稱 / 品牌
- 主要標題(H1)— 可以包含一個用於漸層效果的重點詞
- 標語或副標題
- 要包含的區塊(精確列出 — 不要額外添加)
- 主要行動呼籲:標籤 + 動作
- 次要行動呼籲(選填):標籤 + 動作
- 主要主題顏色(十六進位色碼或描述)
- 模式:淺色或深色?
- 個性:簡潔/輕盈、編輯/層次、大膽/動感或結構化?(如果不確定,請描述感覺)
- 是否包含聯絡表單或電子報?(是/否 — 請具體說明)
階段 1 — 視覺解析度
在撰寫任何程式碼之前,根據收集到的答案解析 VISUAL DIRECTIVE。
色票映射:
- 鮮豔 / 充滿活力的顏色 → Vibrant
- 中性 / 柔和 / 灰色調 → Neutral
- 企業藍 / 綠 → Corporate
- 紫色 / 粉紅 / 創意 → Creative
個性映射(來自問題 10):
- 簡潔 / 極簡 / 輕盈 → Airy
- 編輯 / 層次 / 不對稱 → Layered
- 大膽 / 強烈 / 動感 → Kinetic
- 結構化 / 正式 / 資料密集 → Structured
建立此區塊並帶入階段 2:
VISUAL DIRECTIVE:
- Palette: [Vibrant / Neutral / Corporate / Creative]
- Personality: [Kinetic / Airy / Structured / Layered]
- Mode: [light / dark]
- Animation: [neus-fade-up on .hero-copy / none]
- Layout: [asymmetric 2-col hero 1.4fr/0.6fr / centered hero]
- H1: [clamp(2.5rem,6vw,4rem) weight-800 / clamp(2rem,4vw,3rem) weight-700]
- Gradient text: [yes — accent word: "[word]" / no]
- Surfaces: [glass (dark-surfaces.md) / standard var(--color-white)]
- Nav: [glass sticky / standard sticky / none]
深色模式規則: 如果 Mode: dark,所有表面都使用 dark-surfaces.md 中的食譜。切勿使用 var(--color-white) 作為頁面或區塊背景。對內容卡片使用 <Card variant="glass"> — 這是 Neus UI 的玻璃表面。切勿將其替換為原始的 <div> + 自訂 CSS。
淺色模式規則: 如果 Mode: light,對內容卡片使用 Neus UI <Card>,對交替區塊背景使用 var(--color-primary-light),對頁面根元素使用 var(--color-white)。
階段 2 — P0 驗證
- 輸出區塊 == 收集到的區塊(問題 5)。零額外內容。
- 沒有虛構的文案 — 所有文字都來自收集到的資料,或明確由 props 驅動
- 沒有 AppTemplate 或側邊欄
- VISUAL DIRECTIVE 已建立並帶入
- 深色模式:所有表面使用玻璃食譜,沒有
var(--color-white)背景 - 淺色模式:內容使用 Neus UI
<Card>,交替區塊使用 primary-light
階段 3 — 產生成品
按此順序產生三個檔案:PageName.types.ts → PageName.tsx → PageName.styles.css。
PageName.types.ts
import type { BadgeColor } from 'neus-ui';
export type NavItem = {
label: string;
href: string;
};
// 僅從收集到的資料新增區塊特定類型
export type Article = {
id: string;
title: string;
href?: string;
excerpt?: string;
author?: string;
meta?: string;
categories?: string[];
};
// 類別 → 徽章顏色映射(深色模式:4 種視覺上不同的顏色)
export const BADGE_COLOR: Record<string, BadgeColor> = {
systems: "primary",
design: "error",
craft: "neutral",
tools: "success",
featured: "primary",
};
export type PageNameProps = {
// 僅適用於來自外部的資料(文章列表、表單處理器等)的 Props
// 靜態行銷文案在元件中硬編碼 — 永遠不應作為 prop
};
PageName.tsx
深色模式結構 — 正確的元件使用方式:
import { useState } from 'react';
import { Button, Card, Link, Input, Badge } from 'neus-ui';
import './PageName.styles.css';
import type { PageNameProps, Article } from './PageName.types';
import { BADGE_COLOR } from './PageName.types';
export const PageName = ({ articles, onSubscribe }: PageNameProps) => {
const [email, setEmail] = useState('');
const [subscribed, setSubscribed] = useState(false);
const [loading, setLoading] = useState(false);
const handleSubscribe = () => {
setLoading(true);
onSubscribe?.(email);
setSubscribed(true);
setLoading(false);
};
return (
<div className="page-name">
{/* 裝飾性背景圖層 — aria-hidden,不可互動 */}
<div className="page-name__mesh" aria-hidden="true" />
<div className="page-name__grid" aria-hidden="true" />
<div className="page-name__content">
{/* 固定玻璃導覽列 — 連結使用 <Link type="secondary"> */}
<nav className="page-name__nav">
<div className="page-name__nav-brand">
<div className="page-name__brand-mark" aria-hidden="true">P</div>
<span className="page-name__brand-name">PageName</span>
</div>
<div className="page-name__nav-links">
{navItems.map(item => (
<Link key={item.href} type="secondary" href={item.href} label={item.label} />
))}
</div>
<Button label="Subscribe" variant="solid" color="primary" size="small" onClick={() => {}} />
</nav>
<main>
{/* 英雄區塊 — 不對稱 2 欄 */}
<section className="page-name__hero" aria-labelledby="page-name-title">
<div className="page-name__hero-copy">
{/* 眉毛藥丸 — 原始 div(沒有 Neus UI 對應元件) */}
<div className="page-name__eyebrow-pill">
<span className="page-name__eyebrow-dot" aria-hidden="true" />
PAGENAME
<span aria-hidden="true">/</span>
KEYWORD
</div>
<h1 id="page-name-title">
Headline{" "}
<span className="gradient-text">accent</span>
</h1>
<p className="page-name__hero-sub">來自收集資料的標語。</p>
<div className="page-name__hero-cta">
<Button label="主要 CTA" variant="solid" color="primary" onClick={() => {}} />
<Button label="次要 CTA" variant="outlined" color="primary" onClick={() => {}} />
</div>
</div>
<div className="page-name__hero-visual">
{/* 精選 Card 或藝術面板 — 參閱 dark-landing-patterns.md §4 */}
</div>
</section>
{/* 來自收集資料的內容區塊 — 對卡片使用 <Card variant="glass"> */}
{/* 範例文章網格區塊: */}
<section className="page-name__articles">
<div className="page-name__article-grid">
{articles?.map(article => (
<Card variant="glass" key={article.id} onClick={() => {}}>
<div className="page-name__article-inner">
<div className="page-name__pill-row">
{article.categories?.map(cat => (
<Badge
key={cat}
variant="solid"
color={BADGE_COLOR[cat] ?? "neutral"}
label={cat}
/>
))}
</div>
<h3>{article.title}</h3>
{article.excerpt && <p className="page-name__article-dek">{article.excerpt}</p>}
</div>
</Card>
))}
</div>
</section>
{/* 電子報區塊(如果要求的話) */}
<section className="page-name__newsletter" aria-labelledby="page-name-nl-title">
<div className="page-name__nl-card">
<p className="page-name__sec-eyebrow">Newsletter</p>
<h2 id="page-name-nl-title">
Stay in the loop.{" "}
<span className="gradient-text">No noise.</span>
</h2>
{subscribed ? (
<p className="page-name__nl-success">✓ 您已訂閱 — 感謝!</p>
) : (
<div className="page-name__nl-form">
<Input
name="newsletter-email"
type="email"
label="Email"
placeholder="[email protected]"
value={email}
onChange={setEmail}
required
/>
<Button
label="Subscribe"
type="submit"
variant="solid"
color="primary"
loading={loading}
onClick={handleSubscribe}
/>
</div>
)}
</div>
</section>
</main>
{/* 頁尾 — 連結使用 <Link type="secondary"> */}
<footer className="page-name__footer">
<span>© {new Date().getFullYear()} PageName.</span>
<div className="page-name__footer-links">
<Link type="secondary" href="/privacy" label="Privacy" />
<Link type="secondary" href="/contact" label="Contact" />
</div>
</footer>
</div>
</div>
);
};
淺色模式結構: 省略 mesh/grid div 和內容包裝器。內容卡片使用 <Card>(無 variant)。使用 background: var(--color-primary-light) 交替區塊背景。主要連結使用 <Link type="primary">,導覽/頁尾使用 <Link type="secondary">。類別藥丸仍使用 <Badge>。
功能磚塊(兩種模式):
<Card variant="glass" icon={...} title="..." description="..." />(深色)<Card icon={...} title="..." description="..." />(淺色)
聯絡表單(如果要求的話): 使用 Neus UI <Input> 欄位 + <Button type="submit">。模式與電子報相同,但沒有發光卡片包裝器。
PageName.styles.css
深色模式: 從 dark-surfaces.md §1 的 canvas + mesh + grid + content 食譜開始。然後新增玻璃導覽(§3)、nl-card(§4)、眉毛藥丸(§5)、漸層文字(§6)、藝術面板(§8 如果精選)、元資料行(§9 如果有文章)、頁尾(§10)。沒有自訂卡片 CSS — <Card variant="glass"> 會處理。佈局套用自 dark-landing-patterns.md。
淺色模式: 從 background: var(--color-white); color: var(--color-gray-900) 開始。對交替區塊背景使用 var(--color-primary-light)。遵循 design-personality.md 第 4–5 節的排印和間距。
兩種模式:
@keyframes neus-fade-up {
from { opacity: 0; transform: translateY(16px); }
to { opacity: 1; transform: translateY(0); }
}
.page-name__hero-copy {
animation: neus-fade-up 0.5s ease both;
}
/* 漸層文字工具 */
.gradient-text {
background: linear-gradient(135deg, #22d3ee 0%, #818cf8 45%, #d946ef 100%);
-webkit-background-clip: text;
-webkit-text-fill-color: transparent;
background-clip: text;
}
/* 最大寬度容器 */
.page-name__hero,
.page-name__articles,
.page-name__newsletter,
.page-name__footer {
max-width: min(72rem, 100%);
margin: 0 auto;
}
/* 區塊內邊距 */
.page-name__hero { padding: 6rem 2rem; }
.page-name__articles { padding: 6rem 2rem; }
.page-name__newsletter { padding: 5rem 2rem; }
/* 英雄區塊網格 */
.page-name__hero {
display: grid;
grid-template-columns: 1.4fr 0.6fr;
gap: 3rem;
align-items: center;
}
/* H1 */
.page-name__hero h1 {
font-family: var(--font-display);
font-size: clamp(2.5rem, 6vw, 4rem);
font-weight: 800;
letter-spacing: -0.04em;
line-height: 0.98;
margin: 0.5rem 0 1rem;
}
/* 電子報表單 — 彈性列 */
.page-name__nl-form {
display: flex;
gap: 1rem;
align-items: flex-end;
max-width: 520px;
margin: 0 auto;
}
/* 文章網格 */
.page-name__article-grid {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: 1.5rem;
}
/* 藥丸列 */
.page-name__pill-row {
display: flex;
flex-wrap: wrap;
gap: 0.5rem;
margin-bottom: 0.75rem;
}
/* 響應式 */
@media (max-width: 960px) {
.page-name__hero { grid-template-columns: 1fr; }
.page-name__article-grid { grid-template-columns: 1fr; }
}
@media (max-width: 640px) {
.page-name__hero,
.page-name__articles,
.page-name__newsletter { padding: 5rem 1.25rem; }
}
共享規則(內嵌)
這些規則永遠有效。即使未讀取
_shared/檔案,它們仍然適用。
輸出 — 始終三個檔案
每個技能輸出:ComponentName.types.ts → ComponentName.tsx → ComponentName.styles.css。
無內聯樣式(style={{}})。元件內無 <style> 標籤。CSS 僅在 .styles.css 中。
匯入
import { Button, Card, Input, Badge, Link, Select, Modal, DataTable } from 'neus-ui';
絕不
…
[為翻譯而截斷]