Public showcase of my integration & full-stack work on The Grid, a multilingual motorsport-agency website. The production code lives in a private repository — this repo presents the architecture, the front-end craft, the headless CMS, and the SEO system, with a handful of representative (non-sensitive) code excerpts.
Built by Simon Azoulay — GraciaMedia. Design integration, front-end engineering, headless CMS architecture, i18n & SEO.
A fully localized agency site (driver roster, news/case-studies, services, contact) built on a modern React Server Components stack with a headless CMS that lets a non-technical team run the site — content, translations, and even the visual theme — entirely from an admin back office.
| Framework | Next.js 16 (App Router, React Server Components) |
| Language | TypeScript (strict) |
| CMS | Payload 3 (headless, Lexical editor, French-labeled admin) |
| Database | Postgres (Neon) in prod · SQLite locally |
| Styling | Tailwind CSS v4 + CMS-driven design tokens |
| Motion | Framer Motion (scroll parallax, staggered reveals, reduced-motion aware) |
| i18n | next-intl — 7 locales (en, fr, es, de, it, nl, zh) |
| Media / Email / AI | Vercel Blob · Resend · OpenAI (translation + vision) |
| Hosting | Vercel (ISR, on-demand revalidation) |
The front end is component-driven (~55 components organized by feature, not by type) and entirely server-rendered with selective client interactivity.
- Pixel-faithful integration of the agency design across home, about, services, drivers list + driver detail, news list + article, and contact.
- Shared motion language — a single Framer Motion variant library (
snippets/motion.tsx) keeps timing, easing and stagger consistent everywhere;prefers-reduced-motionis honored globally via<MotionConfig reducedMotion="user">. - Scroll-driven effects — hero parallax (
useScroll+useTransform), an F1-inspired headlight-beam sweep on the About section, staggered card reveals, glassmorphism sticky header on scroll. - Fluid responsive layout —
clamp()typography/spacing, container-aware breakpoints, scroll-snap carousels, mobile-specific overlays. Mobile-first. - Image pipeline —
next/imagewith AVIF/WebP, art-directedsizes, CMS focal points (object-position), CDN + Vercel Blob sourcing, immutable long-TTL caching. - Typography —
next/font(Poppins, League Spartan, Inter, Syne) with swap + preloading strategy per font.
A standout integration piece: the visual theme is data. A Payload global exposes
typed design knobs (accent color, card radius, hover style, section spacing, hero
scale, global font, header style…) that resolve server-side into CSS custom properties
injected in <head>. The team re-themes the entire site from the admin — no deploy.
→ snippets/design-settings.ts
The site is fully editable by a non-technical team through a French-labeled Payload admin, structured into 8 collections and 7 globals.
Collections — News (block-based articles), Drivers (profiles, careers, galleries), Team Members, News Tags (URL-stable filters), Media, Newsletter Subscribers, Contact Submissions, Users.
Globals — Homepage, About, Services, Drivers, Contact pages, Site Settings, and Design Settings — each with configurable section ordering and per-page SEO.
Key engineering:
- Non-destructive AI translation. English is canonical. On save, an endpoint walks
the Payload schema, extracts every localized text field (nested groups, tabs, arrays,
blocks), and translates via OpenAI — preserving placeholders, inline HTML, brand
names and slugs. A
lockedLocalesmechanism means a human edit to any locale is never overwritten by the machine. - AI media descriptions. Uploaded images are auto-described via OpenAI Vision (alt/subject/tags), run in the background so uploads stay fast.
- Reusable field factories — a localized
seoField()and an image/focal-point field drop into any collection or global (snippets/seo-field.ts). - Hooks for cache correctness —
afterChange/afterDeletetrigger targeted, locale-aware ISR revalidation, so a save in the admin reflects on production in seconds without a rebuild. - Custom admin components — media-library image picker, design-settings UI, per-locale translation-status indicators, bulk CSV export for leads.
- Server-side access control — public read, authenticated writes; public create only on form-submission collections.
SEO is treated as a first-class subsystem, fully driven by the typed locale table.
- hreflang + canonical — correct
alternatesfor all 7 locales,x-default, trailing-slash–normalized canonicals. Hreflang is only emitted for locales that actually have a translation. - Per-locale OpenGraph (
en_US,fr_FR, …) and Twitter cards. - JSON-LD structured data — Organization + WebSite site-wide; NewsArticle and
Person schemas on detail pages, emitted safely per Next.js 16 guidance
(
snippets/json-ld.ts). - Editable meta — every page/collection carries a localized
seoFieldso editors control<title>/description/OG image, with translated defaults as fallback. - Database-backed sitemaps — a sitemap index plus one sitemap per locale, generated from live CMS content, cached and revalidated.
robots.txtthat explicitly welcomes AI crawlers (GPTBot, ClaudeBot, PerplexityBot…) while protecting/adminand/api.- Trailing-slash invariant enforced once in middleware (308) and matched across links, canonicals and sitemaps — no redirect loops, no duplicate URLs.
- Schema self-heal — an idempotent pre-build step creates any missing relationship tables/indexes, hardening serverless cold-start builds.
- Retry wrapper around CMS reads to tolerate database cold starts.
- Security headers — HSTS, CSP,
X-Content-Type-Options, referrer & permissions policies, COOP/CORP. - CI mirrors the deploy — type-check + lint + build run in GitHub Actions before every deploy.
Representative, non-sensitive excerpts (trimmed and lightly adapted to stand alone):
| File | What it shows |
|---|---|
snippets/motion.tsx |
Shared Framer Motion variant library |
snippets/i18n-config.ts |
7-locale source of truth feeding routing + SEO |
snippets/design-settings.ts |
CMS-driven design tokens → CSS variables |
snippets/seo-field.ts |
Reusable localized SEO field factory (Payload) |
snippets/json-ld.ts |
Safe JSON-LD structured-data helpers |
No credentials, environment values, client data, or proprietary content are included in this repository. Code excerpts are illustrative and provided for portfolio purposes.