# Prompt para criar uma página de preços SaaS em Next.js

> Prompt de IA copiável para criar uma página de preços SaaS em Next.js com Tailwind, alternância de cobrança e dados de plano prontos para Stripe.

**Type:** Prompt  
**Tools:** Cursor, Claude Code, Codex, Windsurf  
**Stack:** Next.js, TypeScript, Tailwind  
**Difficulty:** easy  
**Updated:** 2026-06-08

---

Use este prompt para gerar uma página de preços polida e otimizada para conversão, com um alternador de cobrança mensal/anual, um nível destacado "Mais Popular" e uma configuração de plano tipada que se conecta diretamente ao Stripe Checkout — sem dados de placeholder.

## Prompt Principal

```txt title="Main Prompt"
You are working in a Next.js App Router project using TypeScript and Tailwind CSS v4.

Task: create a `/pricing` page with the following specification.

Plan data:
- Starter: $0/mo, $0/yr — 1 user, 5 projects, community support.
- Pro: $19/mo, $190/yr — 5 users, unlimited projects, email support. Mark as "Most Popular".
- Enterprise: $99/mo, $990/yr — unlimited users, SSO, dedicated support.

UI requirements:
- A client component `<PricingToggle>` with monthly/annual switch; annual shows "Save 17%".
- A `<PricingCard>` component per plan with: name, price, feature list, CTA button.
- "Most Popular" card has a highlighted border and badge.
- CTA buttons call `handleCheckout(planId, interval)` — stub it for now, we will wire Stripe later.
- The page file itself must be a Server Component; only the toggle and cards are Client Components.
- Use Tailwind utility classes only — no CSS modules, no inline styles.

Type requirements:
- Export a `Plan` interface from `src/lib/pricing.ts`.
- Plan data lives in that same file as a `const PLANS: Plan[]`.

Do NOT install any new packages. Stop and list all files before writing code.
```

## Notas de Implementação

- A página deve ser um Server Component para que seja renderizável estaticamente; eleve `'use client'` apenas para os componentes de alternância e card que precisam de `useState`.
- `handleCheckout` deve aceitar `(planId: string, interval: 'monthly' | 'annual')` — esta assinatura corresponde ao prompt do Stripe Checkout, então mantenha-a estável.
- Tailwind v4 usa configuração CSS-first; evite `tailwind.config.ts` a menos que já exista.

## Mudanças Esperadas nos Arquivos

```txt
src/app/pricing/page.tsx            (new — Server Component)
src/components/PricingToggle.tsx    (new — Client Component)
src/components/PricingCard.tsx      (new — Client Component)
src/lib/pricing.ts                  (new — Plan type + PLANS constant)
```

## Critérios de Aceitação

- `bun run build` sai com 0 sem erros de TypeScript.
- Alternar mensal/anual atualiza os preços dos três cards sem recarregar a página.
- O selo "Mais Popular" está visível no card Pro.
- `handleCheckout` é chamado com o `planId` e `interval` corretos quando um CTA é clicado.

## Comandos de Teste

```bash
bun run typecheck
bun run build
bun run dev
# open http://localhost:3000/pricing and verify toggle behavior
```

## Erros Comuns da IA

- Marcar o próprio arquivo da página como `'use client'`, o que anula a renderização do servidor.
- Codificar preços diretamente no JSX em vez de derivá-los de `PLANS`.
- Usar padrões de `theme.extend` em `tailwind.config.ts` que não se aplicam ao Tailwind v4.
- Esquecer de exportar o tipo `Plan`, quebrando a integração com Stripe Checkout posteriormente.

## Prompt de Correção

```txt title="Fix Prompt"
The pricing page has type errors or the toggle doesn't work. Fix in this order:
1. Remove `'use client'` from `src/app/pricing/page.tsx` — only the child components need it.
2. Make sure `PricingToggle` uses `useState` for the billing interval and passes it down via props.
3. Confirm `handleCheckout` signature is `(planId: string, interval: 'monthly' | 'annual') => void`.
Show the corrected diff only — do not rewrite unrelated files.
```