bento-design
Skill0 starsChanged 4 months agoMITView on GitHub
Use when building website sections, landing pages, feature showcases, or dashboards that need a modern, scannable grid layout. Bento grids are modular layouts inspired by Japanese bento boxes, popularized by Apple's product pages. ✅ Use for: - Feature showcases (5-10 distinct features) - Landing page hero sections - Dashboard overviews with mixed content types - Portfolio/case study pages - Stats/metrics displays - Product capability overviews ❌ Don't use for: - Long-form content (blog posts, documentation) - Simple lists or tables…
In this repository37 other files it gives its agents.
- .agents/skills/vercel-composition-patterns/AGENTS.mdAGENTS.md
- vercel-composition-patterns/AGENTS.mdAGENTS.md
- senior-frontendSkill
- vercel-composition-patternsSkill
- fanned-cardsSkill
- flip-cardSkill
- floating-quotesSkill
- githubSkill
- glassmorphism-uiSkill
- gmail-proxySkill
- googleSkill
- hippocampusSkill
- html-pdf-exportSkill
- iframe-previewSkill
- infinite-canvasSkill
- matrix-textSkill
- nextjs-apiSkill
- nextjs-expertSkill
- pinterestSkill
- railway-deploySkill
- remotion-videoSkill
- scramble-textSkill
- scroll-video-heroSkill
- senior-frontendSkill
- SEOSkill
- ship-websiteSkill
- sound-engineSkill
- stripe-best-practicesSkill
- tilt-cardSkill
- tube-summarySkill
- upload-postSkill
- vercel-composition-patternsSkill
- vercel-deploySkill
- vercel-react-best-practicesSkill
- vertical-fanned-cardsSkill
- video-contentSkill
- war-roomSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 7 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 3
Use when building website sections, landing pages, feature showcases, or dashboards that need a modern, scannable grid layout.
- Distinctive: line 43
Use a 12-column base grid with Tailwind CSS Grid:
- Distinctive: line 98
Use subtle gradients or glows on hero cards to draw attention
- Distinctive: line 175
No visual hierarchy: - If everything is the same size, nothing stands out.
- Distinctive: line 176
Inconsistent gutters: - All gaps must be identical.
- Distinctive: line 178
Forced bento: - Not every page needs bento.
- Distinctive: line 179
No mobile consideration: - Always design mobile-first, then expand to bento on desktop.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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
Bento Grid Design Skill
Use when building website sections, landing pages, feature showcases, or dashboards that need a modern, scannable grid layout. Bento grids are modular layouts inspired by Japanese bento boxes, popularized by Apple's product pages.
When to Use Bento
✅ Use for:
- Feature showcases (5-10 distinct features)
- Landing page hero sections
- Dashboard overviews with mixed content types
- Portfolio/case study pages
- Stats/metrics displays
- Product capability overviews
❌ Don't use for:
- Long-form content (blog posts, documentation)
- Simple lists or tables
- Single-focus hero sections (one message, one CTA)
- Content that needs to be read sequentially
- Pages with fewer than 3 items
Three Core Principles
1. Strict Compartmentalization
Each piece of content lives in its own clearly defined box. Creates "cognitive chunking" so users scan 10+ pieces of information without overload.
2. Size = Visual Hierarchy
The most important content gets the largest box. Not about position, about scale.
- 1x1: Supporting features, secondary info
- 2x1: Mid-tier features, horizontal emphasis
- 1x2: Vertical emphasis, tall content
- 2x2: Hero feature, primary value proposition
- 3x2 or full-width: Detailed demonstrations, key selling point
3. Uniform Spacing (Gutters)
Gaps between boxes must be identical throughout. This creates rhythm.
- Desktop: 16-24px (recommended: 16px or
gap-4) - Tablet: 12-16px
- Mobile: 12px (
gap-3)
Grid System
Use a 12-column base grid with Tailwind CSS Grid:
{/* Base bento container */}
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
{/* Cards go here */}
</div>Card Size Classes
// 1x1 - Standard card
<div className="col-span-1 row-span-1">
// 2x1 - Wide card
<div className="col-span-1 md:col-span-2 row-span-1">
// 1x2 - Tall card
<div className="col-span-1 row-span-2">
// 2x2 - Hero card (largest emphasis)
<div className="col-span-1 md:col-span-2 row-span-2">
// Full width
<div className="col-span-1 md:col-span-2 lg:col-span-3 row-span-1">Visual Design Rules
Card Styling
// Standard bento card
<div className="rounded-2xl bg-neutral-900 border border-neutral-800 p-6 overflow-hidden">Rules:
- Border radius:
rounded-2xl(16px) orrounded-3xl(24px). Stay consistent. - Background: subtle contrast from page background. Dark mode:
bg-neutral-900onbg-neutral-950. Light mode:bg-whiteonbg-gray-50. - Border: very subtle.
border-neutral-800dark,border-gray-200light. - Padding:
p-6minimum. Larger cards can usep-8. - Overflow: always
overflow-hiddento contain images/illustrations.
Content Within Cards
Each card should contain one idea with a maximum of:
- Icon or illustration (optional)
- Headline (required, short)
- Description (optional, 1-2 sentences max)
- Visual/screenshot (optional, bleeds to edges for impact)
Never: multiple CTAs per card, walls of text, unrelated content grouped together.
Visual Interest
- Mix content types: some cards text-only, some with images, some with icons, some with code snippets
- Let images/screenshots bleed to card edges (no padding on image sides)
- Use subtle gradients or glows on hero cards to draw attention
- Consistent icon style across all cards
Responsive Behavior
// The responsive stack pattern
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">| Breakpoint | Columns | Behavior |
| Mobile (<768px) | 1 | All cards stack vertically, full width |
| Tablet (768-1024px) | 2 | 2x1 cards span full width, others stack in 2 cols |
| Desktop (>1024px) | 3 (or 4) | Full bento layout with mixed sizes |
Critical mobile rule: On mobile, ALL cards become 1-column. Never try to maintain the bento grid on small screens. The hierarchy shifts from spatial to sequential.
Card order on mobile: Most important cards first. Use order- classes if the DOM order doesn't match mobile priority:
<div className="order-1 lg:order-none"> {/* First on mobile */}Common Layouts
Layout 1: Feature Showcase (6 features)
┌──────────┬─────┐
│ 2x2 │ 1x1 │
│ Hero ├─────┤
│ Feature │ 1x1 │
├─────┬────┴─────┤
│ 1x1 │ 2x1 │
└─────┴──────────┘Layout 2: Stats + Features (mixed)
┌─────┬─────┬─────┐
│ 1x1 │ 1x1 │ 1x1 │ ← Stats row
├─────┴─────┼─────┤
│ 2x2 │ 1x2 │
│ Hero │ │
├─────┬─────┤ │
│ 1x1 │ 1x1 │ │
└─────┴─────┴─────┘Layout 3: Simple 3-column
┌─────┬──────────┐
│ 1x1 │ 2x1 │
├─────┼─────┬────┤
│ 1x1 │ 1x1 │1x1 │
├─────┴─────┼────┤
│ 2x1 │1x1 │
└───────────┴────┘Complete Example Component
See references/bento-section.tsx for a copy-paste ready React component.
Inspiration Sources
- bentogrids.com (curated collection)
- Apple product pages (the OG)
- Linear.app features page
- Notion landing page
- Vercel homepage
- Diagram.com
- Customer.io features
- onepagelove.com/tag/bento
Anti-patterns
- Too many cards - Max 8-10. More than that becomes a cluttered mess.
- All same size - That's just a card grid, not bento. Mix sizes for hierarchy.
- No visual hierarchy - If everything is the same size, nothing stands out.
- Inconsistent gutters - All gaps must be identical.
- Too much text - Bento is for scanning, not reading. Keep copy tight.
- Forced bento - Not every page needs bento. Use it when you have multiple distinct things to showcase, not as a default layout.
- No mobile consideration - Always design mobile-first, then expand to bento on desktop.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
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.

