# Create page

> Have your agent build a complete page from blocks, with your own content in them, one shared navbar and footer, and a check in light and dark mode at the end.

## Usage

### Run the skill

Say which page you want, where it goes and what it's for. Add the content you have, or point the agent to it.

```text title="Prompt"
/shadcnpro-create-page A pricing page at /pricing for Acme, a time tracker for agencies. Three plans: Free, Team at $12 per seat and Business at $29 per seat. The goal is a free trial signup. Take the product copy from the README.
```

### Approve the plan

The agent lists the sections with the block it picked for each and why, and waits for your yes before it installs anything.

### Read the report

The agent tells you what it built, what it checked and what is still open, such as images you still have to supply.

The project needs the registry set up. If it isn't, the agent runs [`/shadcnpro-setup-blocks`](https://pro.shadcn.co/docs/agent-skills/setup-blocks) first.

## What the skill does

1. Gets the brief: the page, its route, its goal and the content that exists. It reads your README and existing pages before it asks.
2. Reads the project: the framework, the UI library, how pages are built and which blocks are installed already.
3. Plans the sections with [`/shadcnpro-choose-blocks`](https://pro.shadcn.co/docs/agent-skills/choose-blocks).
4. Installs the blocks in one command, after a dry run that shows what will change.
5. Creates the route the way your project builds pages.
6. Replaces the sample content of every block with yours.
7. Checks the result: types and lint, then the page in the browser at mobile and desktop width, in light and dark mode.

## Your content, not sample content

Blocks arrive with placeholder copy, logos, photos and links. The skill goes through every block and replaces what a visitor can see:

| In the block | In your page |
|---|---|
| Headlines, descriptions, button labels | Your copy, short and specific |
| Sample brand and product names | Yours, also in `alt` text and labels |
| Placeholder logos and photos | Your images. If you have none yet, the placeholders stay and the report lists them. |
| Sample people and quotes | Real ones. Otherwise the section is removed. |
| `href="#"` | Real routes, or anchors to sections on the page |
| Plans, prices and numbers | The real values. The agent asks when it doesn't know. |

The agent never invents facts: no made-up customers, quotes, numbers or prices. What it couldn't fill in is listed as open in the report.

## One navbar and one footer

On a site with several pages, the navbar and the footer belong in a shared layout, not in each page. The skill puts them there, reuses the ones your site already has, and keeps full-page blocks such as sign-in, checkout and dashboards outside that layout.

In Next.js the page stays a server component, so its `metadata` works, and the agent writes a title and a description for the page. The skill also covers the Next.js Pages Router, React Router, Remix and TanStack Router.

## Your files are safe

Some blocks bring files your project already has: a `components/ui` file you changed, or a page file. `dashboard-01`, for example, writes `app/page.tsx`. The skill previews every install, keeps your versions and creates the block's page at the route you asked for.

Installed blocks are edited in place and keep their file names, so you can still compare them with the registry later, as shown in [Update a block](https://pro.shadcn.co/docs/blocks#update-a-block).

## What it wires up

- **Anchors**: sections get an `id`, and the navbar links point at them.
- **Links**: links inside your app use your framework's link component.
- **Headings**: one `h1` per page, in the first section.
- **Forms**: blocks ship forms without a submit handler. Tell the agent where the data goes, and it wires them. Otherwise it leaves them and lists them as not wired.

## Tips for better results

- **Bring the content.** Plans, prices, quotes and images are yours to give. The agent writes careful copy from what the project tells it, and lists every assumption.
- **Apply your brand.** Blocks follow your theme. Run [`/shadcnpro-apply-brand`](https://pro.shadcn.co/docs/agent-skills/apply-brand) before or after, and every page follows.
- **Keep a dev server running.** The agent checks the page there, and asks before it starts one.
- **Missing a section?** [`/shadcnpro-create-block`](https://pro.shadcn.co/docs/agent-skills/create-block) writes one that matches the others.
