antigravity-skills-reference/skills/ui-page/SKILL.md

name, description, category, risk, source, source_repo, source_type, date_added, author, tags, tools

name	description	category	risk	source	source_repo	source_type	date_added	author	tags	tools
ui-page	Scaffold a new mobile-first page using StyleSeed Toss layout patterns, section rhythm, and existing shell components.	design	safe	community	bitjaru/styleseed	community	2026-04-08	bitjaru	ui page-design mobile layout styleseed	claude cursor codex gemini

UI Page

Overview

Part of StyleSeed, this skill scaffolds a complete page or screen using the Toss seed's mobile-first composition rules. It keeps page structure consistent by building on the existing shell, top bar, bottom navigation, and card rhythm instead of producing disconnected sections.

When to Use

• Use when you need a new page in a Toss-seed app
• Use when you want a consistent page shell, spacing, and navigation structure
• Use when you are adding a new product flow and need a solid starting layout
• Use when you want to stay mobile-first even if the project later expands to larger breakpoints

How It Works

Step 1: Inspect the Existing Shell

Read the current page scaffolding patterns first, especially:

• page shell
• top bar
• bottom navigation
• representative pages using the same route family

Step 2: Define the Page Purpose

Clarify:

• the page name
• the primary user question the screen answers
• the top one or two actions the user should take

Every screen should have one dominant purpose.

Step 3: Use the Information Pyramid

Lay out the page from highest importance to lowest:

1. Hero or top summary
2. KPI or key actions
3. detail cards or supporting modules
4. lists, history, or secondary content

Avoid repeating the same section type mechanically from top to bottom.

Step 4: Apply the Toss Layout Rules

Default layout choices:

• mobile viewport width around max-w-[430px]
• page background on bg-background
• horizontal padding around px-6
• section rhythm with space-y-6
• generous bottom padding if a bottom nav is present
• cards using semantic surface tokens, rounded corners, and light shadows

Step 5: Compose Instead of Rebuilding

Use existing ui/ and patterns/ components wherever possible. New pages should primarily orchestrate existing building blocks, not recreate them.

Step 6: Account for Real Device Constraints

• handle safe-area insets
• avoid horizontal overflow
• keep interactive clusters thumb-friendly
• ensure long content scrolls cleanly without clipping the bottom navigation

Output

Return:

1. The page scaffold
2. The chosen section structure
3. Reused components and any newly required components
4. Empty, loading, and error states that the page will need next

Best Practices

• Keep the first version structurally correct before adding decoration
• Use one strong hero instead of multiple competing highlights
• Preserve navigation consistency across sibling screens
• Prefer reusable section components when the page will likely repeat

Additional Resources

• StyleSeed repository
• Source skill