CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a Next.js landing page for BuildRTP, a student-driven organization in the Research Triangle Park area. The site promotes their LaunchUP pitch competition and provides information about the organization.

Technology Stack

Framework: Next.js 15 with App Router
Language: TypeScript
Styling: Tailwind CSS with custom design tokens
UI Components: shadcn/ui component library
Icons: Lucide React
Analytics: Vercel Analytics
Font: Montserrat (Google Fonts)
Database: Airtable (for check-in system)

Development Commands

# Start development server with Turbopack
npm run dev

# Build for production
npm run build

# Start production server
npm start

# Run ESLint
npm run lint

Project Structure

src/
├── app/                    # Next.js App Router pages
│   ├── api/               # API routes for check-in system
│   │   ├── auth/         # Authentication endpoints
│   │   ├── checkins/     # Check-in CRUD operations
│   │   └── team-members/ # Team member management
│   ├── layout.tsx         # Root layout with Montserrat font
│   ├── page.tsx           # Home page with all main components
│   └── launchup/          # LaunchUP event detail page
│       └── page.tsx
├── components/            # React components
│   ├── ui/               # shadcn/ui base components
│   ├── header.tsx        # Site navigation
│   ├── hero-section.tsx  # Main hero banner
│   ├── event-card.tsx    # Event promotion component
│   ├── about-section.tsx # About BuildRTP
│   ├── sponsors-section.tsx # Sponsor showcase
│   └── footer.tsx        # Site footer
├── lib/                   # Utility libraries
│   ├── utils.ts          # Utility functions (cn helper)
│   ├── airtable-store.ts # Airtable data operations
│   ├── checkin-store.ts  # Check-in state management
│   └── checkin-client.ts # Check-in API client
└── types/
    └── checkin.ts        # TypeScript definitions for check-in system

Design System

Colors

```
mainblue
```
: #00a8cc (primary brand color)
```
secondaryblue
```
: #006699 (secondary brand color)
```
orange
```
: #ff6600 (accent color for CTAs)

Typography

Primary font: Montserrat (weights: 400, 700)
Font variable:
```
--font-montserrat
```

Key Features

Event Management

Event details are hardcoded in
```
src/app/page.tsx
```
(EventCard component)
LaunchUP specific page at
```
/launchup
```
with detailed event information
Registration links point to external forms (Tally)

Check-in System

Airtable-backed visitor and team member check-in/checkout system
API routes for managing check-ins, team members, and authentication
Support for visitor, team member, and event-based check-ins
Real-time check-in status tracking

Redirect from
```
/eventproposal
```
to Google Docs form (configured in
```
next.config.ts
```
)
Static header navigation

Analytics

Vercel Analytics integrated in root layout

Component Architecture

Modular Design: Each section is a separate component
shadcn/ui Integration: Uses shadcn/ui for consistent base components (Button, Card, Badge)
Responsive: Mobile-first responsive design with Tailwind classes
Type Safety: Full TypeScript coverage

Development Notes

Uses Next.js App Router (not Pages Router)
ESLint configured with Next.js and TypeScript rules
No testing framework currently configured
API routes integrated with Airtable for check-in functionality
Images stored in
```
public/
```
directory
Uses path aliases:
```
@/*
```
maps to
```
./src/*
```
Environment variables required for Airtable integration (not committed to repo)

Content Updates

Event information in

src/app/page.tsx

and

src/app/launchup/page.tsx

Sponsor logos in
```
public/logos/
```
Site metadata in
```
src/app/layout.tsx
```
Check-in system data models in
```
src/types/checkin.ts
```
Airtable configuration in
```
src/lib/airtable-store.ts
```

API Architecture

The check-in system uses the following API structure:

```
GET/POST /api/checkins
```
- Manage check-in records
```
POST /api/checkins/[id]/checkout
```
- Handle checkout operations
```
GET /api/team-members
```
- Retrieve team member data
```
POST /api/auth
```
- Authentication endpoints

Data flows through:

Airtable (external database)
API routes (server-side)
Client-side stores for state management
React components for UI

Project Structure

src/
├── app/                    # Next.js App Router pages
│   ├── api/               # API routes for check-in system
│   │   ├── auth/         # Authentication endpoints
│   │   ├── checkins/     # Check-in CRUD operations
│   │   └── team-members/ # Team member management
│   ├── layout.tsx         # Root layout with Montserrat font
│   ├── page.tsx           # Home page with all main components
│   └── launchup/          # LaunchUP event detail page
│       └── page.tsx
├── components/            # React components
│   ├── ui/               # shadcn/ui base components
│   ├── header.tsx        # Site navigation
│   ├── hero-section.tsx  # Main hero banner
│   ├── event-card.tsx    # Event promotion component
│   ├── about-section.tsx # About BuildRTP
│   ├── sponsors-section.tsx # Sponsor showcase
│   └── footer.tsx        # Site footer
├── lib/                   # Utility libraries
│   ├── utils.ts          # Utility functions (cn helper)
│   ├── airtable-store.ts # Airtable data operations
│   ├── checkin-store.ts  # Check-in state management
│   └── checkin-client.ts # Check-in API client
└── types/
    └── checkin.ts        # TypeScript definitions for check-in system

Key Features

Event details are hardcoded in

src/app/page.tsx

(EventCard component)

LaunchUP specific page at

/launchup

with detailed event information

Registration links point to external forms (Tally)

Airtable-backed visitor and team member check-in/checkout system

API routes for managing check-ins, team members, and authentication

Support for visitor, team member, and event-based check-ins

Real-time check-in status tracking

Redirect from

/eventproposal

to Google Docs form (configured in

next.config.ts

)

Static header navigation

Vercel Analytics integrated in root layout

Development Notes

Uses Next.js App Router (not Pages Router)

ESLint configured with Next.js and TypeScript rules

No testing framework currently configured

API routes integrated with Airtable for check-in functionality

Images stored in

public/

CLAUDE.md

CLAUDE.md

Project Overview

Technology Stack

Development Commands

Project Structure

Design System

Colors

Typography

Key Features

Event Management

Check-in System

Navigation

Analytics

Component Architecture

Development Notes

Content Updates

API Architecture

Related Skills

Markdown Converter

Nano Banana Pro

1password

CLAUDE.md

Project Overview

Technology Stack

Development Commands

Project Structure

Design System

Colors

Typography

Key Features

Event Management

Check-in System

Navigation

Analytics

Component Architecture

Development Notes

Content Updates

API Architecture