# TEMPLATE.md: Freelancer & digital services

You are an AI developer building a complete website for my client. Template: **Freelancer & digital services**. Marketing, VA and editing work: portfolio, service packages, process, case studies with real numbers.

## What you are building

A Next.js (App Router) site assembled from production-ready LudusVibe UI sections. Sections install through the shadcn registry and automatically follow the project's brand tokens.

## Steps

### 1. Project and registry

If the project does not exist yet: `npx create-next-app@latest my-site --ts --tailwind --app`, then `npx shadcn@latest init`.
Add the registry to `components.json`:

```json
"registries": {
  "@ludusvibe": "https://ui.ludusvibe.com/r/{name}.json"
}
```

### 2. Install the template's sections

```bash
npx shadcn@latest add @ludusvibe/navbar-01 @ludusvibe/hero-17 @ludusvibe/logos-01 @ludusvibe/services-02 @ludusvibe/process-01 @ludusvibe/blog-03 @ludusvibe/testimonials-03 @ludusvibe/pricing-01 @ludusvibe/cta-01 @ludusvibe/contact-01 @ludusvibe/footer-01
```

### 3. Assemble the page in this order

1. `navbar-01`  (Navbar 01: Floating Pill)
   Great for: Modern SaaS, startups, portfolios and product sites that want a light, airy look.
2. `hero-17`  (Hero 17: SaaS over grain gradient)
   Great for: SaaS, startups and digital products that want a modern, vivid first screen.
3. `logos-01`  (Logos 01: Marquee)
   Great for: SaaS and B2B sites with recognizable clients or press mentions.
4. `services-02`  (Services 02: Practice Cards)
   Great for: Law firms, accountants, medical practices and professional services.
5. `process-01`  (Process 01: Horizontal Steps)
   Great for: Services explaining how working together goes: agencies, contractors, clinics.
6. `blog-03`  (Blog 03: Case Study Cards)
   Great for: Agencies and B2B services proving results with case studies.
7. `testimonials-03`  (Testimonials 03: Featured Case)
   Great for: Agencies, consultants and B2B selling on measurable results.
8. `pricing-01`  (Pricing 01: Three Tiers)
   Great for: SaaS, subscriptions and service packages with a clear middle recommendation.
9. `cta-01`  (CTA 01: Centered Card)
   Great for: Any site that needs a strong closing call to action: services, SaaS, agencies.
10. `contact-01`  (Contact 01: Form & Map)
   Great for: Any business with an office or premises to visit.
11. `footer-01`  (Footer 01: Mega Footer)
   Great for: Larger sites with many pages: SaaS, shops, media.

In `app/page.tsx`:

```tsx
import { Navbar01 } from "@/components/sections/navbar-01"
import { Hero17 } from "@/components/sections/hero-17"
import { Logos01 } from "@/components/sections/logos-01"
import { Services02 } from "@/components/sections/services-02"
import { Process01 } from "@/components/sections/process-01"
import { Blog03 } from "@/components/sections/blog-03"
import { Testimonials03 } from "@/components/sections/testimonials-03"
import { Pricing01 } from "@/components/sections/pricing-01"
import { Cta01 } from "@/components/sections/cta-01"
import { Contact01 } from "@/components/sections/contact-01"
import { Footer01 } from "@/components/sections/footer-01"

export default function Page() {
  return (
    <>
      <Navbar01 />
      <Hero17 />
      <Logos01 />
      <Services02 />
      <Process01 />
      <Blog03 />
      <Testimonials03 />
      <Pricing01 />
      <Cta01 />
      <Contact01 />
      <Footer01 />
    </>
  )
}
```

Pass `as="h1"` to the first hero section.

### 4. Branding (ask the client before choosing)

All colors live as CSS tokens in `app/globals.css`. Change ONLY tokens, never colors inside components:
- `--primary` and `--primary-foreground`: the brand color (in both themes, :root and .dark)
- `--chart-1` through `--chart-5`: accent colors for charts and visual elements
- Font: swap the font in `app/layout.tsx` (next/font)

### 5. Content

Every section takes its content through props (headings, copy, items, images, CTAs). Replace the default content with the client's real data: names, services, prices, photos, contact, social links.

Copy rules:
- Sales-driven and concrete: benefits first, numbers where they exist
- NEVER use the em dash (—): use a colon, a comma, or restructure the sentence
- Images: replace the Unsplash defaults with the client's photography wherever available

### 6. Verify

- The site works in light and dark themes
- Mobile at 375px with no horizontal scroll
- Every link and CTA points to a real destination (phone, Instagram, form)
