ai-docs/new-developer-intro.md"> ai-docs/new-developer-intro.md"> ai-docs/new-developer-intro.md">

$ cd ilkley-live-website
$ files-to-prompt package.json README.md cypress hooks types utils extapi \\
  components app -e tsx -e ts -e json -e md --cxml | \\
  llm -m o3-mini -s "Please write comprehensive documentation for onboarding a developer to work on this application. Include everything that they'll need to know about. Write using Markdown" \\
  > ai-docs/new-developer-intro.md

Ilkley Live — Developer Onboarding Guide

Welcome to the Ilkley Live codebase! This document is designed to give you a full overview of the project, its architecture, required environment settings, and workflows so you can quickly understand, run, test, and contribute to the application.

Note: This guide assumes you have a working knowledge of JavaScript/TypeScript and React with Next.js.

1. Project Overview

Ilkley Live is a website for a local festival in the Yorkshire town of Ilkley. The application is built using the latest Next.js (App Router), React, and several third-party integrations. The main features include:

Programme & Personal Programme: Displaying artist performances dynamically grouped by time slots and days.
Authentication & User Management: Handled by Clerk for secure sign-up/sign-in.
Content Management: Content (e.g., “About” page and Notion rich-text blocks) are fetched from a Notion database.
Forms for Performer Signup: Uses a combination of client-side validations (with Zod) and integrations with Notion, Mailchimp, and Postmark.
Analytics & Metrics: Using Fathom for tracking page views.
Maps Integration: Google Maps API integration to display static map images integrated with What3Words locations.

2. Technology Stack

Framework: Next.js 13 with the App Router
Language: TypeScript
Styling: Tailwind CSS and utility-first classes (via class-variance-authority)
Authentication: Clerk (for user sessions and user buttons)