building-landing-home
Skill180 starsChanged 12 days agoMITView on GitHub
Compose a product or documentation home page from the @lobehub/ui/awesome landing components: LandingHero, AgentSkillCard, LogoMarquee, LandingSection, BentoGrid/BentoCard, CodeShowcase, FeatureGrid, InstallBanner and FluidGradient. Covers page structure, the lobedocs homePage hook, router links, theming the accent gradient, and a review checklist. Trigger on build a home page, landing page, docs home, marketing page, hero section, redesign home, lobedocs homePage, 首页, 落地页, 官网首页.
- Installs packages
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 2 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Every band of a landing page has a component.
- Very specific: line 19
All components import from @lobehub/ui/awesome.
- Distinctive: line 36
Default order. Drop a band rather than filling it with filler.
- Very specific: line 140
Use footer for secondary links such as skills.md and llms.txt.
- Very specific: line 155
Only the hero's Get Started action is primary.
- Very specific: line 160
Every link resolves: primary action, bento hrefs, prompt URL, footer links.
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Building a landing home with @lobehub/ui/awesome
Every band of a landing page has a component. Your job is to choose the bands, write honest copy and render real product UI inside them, not to restyle containers.
Components
All components import from @lobehub/ui/awesome. Read each one's page before using a prop you
have not seen here: https://ui.lobehub.com/skills/components/awesome/<kebab-name>.md.
| Band | Component | Use it for |
| Opening | LandingHero | Badge, title with gradient accent, description, up to two actions, optional aside column. |
| Beside the hero text | AgentSkillCard | "I'm an Agent / I'm a Human" card: a prompt for coding agents and an install command for people. |
| Under the hero | LogoMarquee | Integrations or supported providers. Icons from @lobehub/icons. |
| Any middle band | LandingSection | Tag, title and description on the left, small actions on the right, content below. Wrap every middle band in it. |
| Live component gallery | BentoGrid + BentoCard | Tiles that render real components; colSpan/rowSpan for emphasis; href to the docs page. |
| Code next to its result | CodeShowcase | Two to four short snippets, each with a live preview. |
| Reasons to choose | FeatureGrid | Three or six cards of icon, title and one-sentence description. |
| Closing call to action | InstallBanner | Title, copyable install command, footnote with license and a docs link. |
| Background texture | FluidGradient | Place it behind a positioned band when you want a texture. Needs a positioned parent. |
Page structure
Default order. Drop a band rather than filling it with filler.
LandingHerowithaside={<AgentSkillCard />}andchildren={<LogoMarquee />}.LandingSection+BentoGrid: the widest, most visual proof.LandingSection+CodeShowcase: how little code it takes.LandingSection+FeatureGrid: foundations such as theming, i18n, performance.InstallBanner.
import {
AgentSkillCard,
InstallBanner,
LandingHero,
LandingSection,
LogoMarquee,
} from '@lobehub/ui/awesome';
import { ArrowRight } from 'lucide-react';
export default function Home() {
return (
<>
<LandingHero
accent="UI Kit"
actions={[
{
href: '/docs',
icon: ArrowRight,
iconPlacement: 'end',
label: 'Get Started',
primary: true,
},
{ href: 'https://github.com/acme/kit', label: 'GitHub' },
]}
aside={
<AgentSkillCard
agent={{
code: 'Read https://kit.acme.dev/skills.md and follow it to build UI with @acme/kit.',
description: 'Send this prompt to your agent to pick the right components',
}}
human={{
code: 'npx skills add acme/kit',
description: 'Install the skills into your project',
}}
/>
}
description="One sentence on what it is and who it is for."
title="Acme"
>
<LogoMarquee items={[/* { icon: OpenAI, label: 'OpenAI' } */]} />
</LandingHero>
<LandingSection
actions={[{ href: '/components', label: 'Browse components' }]}
eyebrow="Components"
id="home-gallery"
title="Built for AI interfaces"
>
{/* BentoGrid of live tiles */}
</LandingSection>
<InstallBanner
command="pnpm add @acme/kit"
footnote="Open source · MIT license"
title="Start building"
/>
</>
);
}Wiring
- lobedocs sites: set
homePage: './docs/home/home.tsx'indocs.config.ts. The default export receives{ description, getStartedPathname }; usegetStartedPathnamefor the primary action. - Client-side routing:
LandingHero,BentoCardandFeatureGridrender plain anchors. Pass one sharedrenderLinkso internal links use the router and absolute URLs open in a new tab:
import type { LandingLinkRender } from '@lobehub/ui/awesome';
import { Link } from 'react-router';
export const renderLink: LandingLinkRender = ({ external, href, ...props }) =>
external ? (
<a href={href} rel="noreferrer" target="_blank" {...props} />
) : (
<Link to={href} {...props} />
);- Accent colour: the gradient on the hero accent, eyebrows, outlined action and install glow
reads
--lobe-landing-gradient. Set it once on:root(and per theme) instead of overriding component styles.FluidGradienttakes its three stops throughcolors. - Search indexing: wrap the title and description in
<span data-pagefind-meta="title">/"description"when the site uses Pagefind.
AgentSkillCard content
- The agent prompt must point at a URL that exists: the site's
skills.md(lobedocs generates it) orllms.txt. Say what the agent should do with it, in one sentence. - The human command must be runnable as written. If the project has no skills package, drop
humanand the card shows the prompt alone. agentsdefaults toDEFAULT_SKILL_AGENTS(Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Cline, OpenCode). Replace it with the.Avatarcomponents from@lobehub/iconsthat the project actually supports, or[]to hide the row.- Use
footerfor secondary links such asskills.mdandllms.txt.
Copy and content rules
- Title: the product name, with the category or promise as
accent. No more than four words. - Description: one sentence, under 20 words, concrete ("React components for AIGC web apps"), never "powerful", "seamless" or "next-generation".
- At most two hero actions: one
primary, one secondary. - Bento tiles render real components with realistic data. A tile that cannot show something live
does not belong in the grid. Give the most expressive component
colSpan={2} rowSpan={2}. CodeShowcasesnippets fit in about ten lines and compile as written.FeatureGriduses three or six items; each description is one sentence.LandingSectionidvalues must be unique; they label the headings.eyebrowis a one- or two-word tag ("Components", "Foundations"); give each band its owneyebrowColorpreset (blue,green,orange…). Give a section at most oneactionsentry.- Only the hero's Get Started action is
primary. Every other action renders asBottomGradientButton; passonNavigate={useNavigate()}so internal ones route client-side.
Review checklist
- Every link resolves: primary action, bento
hrefs, prompt URL, footer links. - Light and dark mode both read well; the accent gradient is not the only thing carrying meaning.
- At 375px wide the hero stacks, actions fill the width, and the bento grid is one column.
- Nothing animates under
prefers-reduced-motion(the marquee stops, the texture freezes). - Copy passes the rules above; no placeholder text or lorem ipsum remains.
Other versions3 projects use a version of this.
Word for word · 3
- lobehub/lobe-icons★ 2.7k100% same
- lobehub/lobe-ui★ 2.2k100% same
- lobehub/lobe-tts★ 809100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .cursor/rules/coding-standards.mdcCursor rule
- .cursor/rules/debug-logging.mdcCursor rule
- .cursor/rules/documentation-standards.mdcCursor rule
- .cursor/rules/environment-setup.mdcCursor rule
- .cursor/rules/hotkey-standards.mdcCursor rule
- .cursor/rules/plugin-development.mdcCursor rule
- .cursor/rules/project-structure.mdcCursor rule
- .cursor/rules/react-development.mdcCursor rule
- using-docs-kitSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

