# CLAUDE.md

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

## Project Overview
This is an AI Conference Deadlines web application that displays submission deadlines for top AI conferences like NeurIPS and ICLR. It's a React/TypeScript web app built with Vite, using shadcn-ui components and Tailwind CSS.

## Development Commands
```bash
# Install dependencies
npm i

# Start development server (runs on http://localhost:8080)
npm run dev

# Build for production
npm run build

# Build for development
npm run build:dev

# Lint code
npm run lint

# Preview production build
npm preview
```

## Architecture

### Core Structure
- **Frontend**: React 18 + TypeScript + Vite
- **UI Framework**: shadcn-ui components with Radix UI primitives
- **Styling**: Tailwind CSS with custom animations
- **Data Source**: Static YAML file (`src/data/conferences.yml`) updated via GitHub Actions
- **State Management**: React hooks, no external state management library

### Key Directories
- `src/components/` - React components (UI components in `ui/` subdirectory)
- `src/pages/` - Route components (Index, Calendar, NotFound)
- `src/data/` - Conference data in YAML format
- `src/types/` - TypeScript type definitions
- `src/utils/` - Utility functions for date handling and conference processing
- `src/hooks/` - Custom React hooks

### Main Components
- `ConferenceList` - Primary list view of conferences
- `ConferenceCard` - Individual conference display card
- `ConferenceDialog` - Detailed conference information modal
- `FilterBar` - Conference filtering and search functionality
- `ConferenceCalendar` - Calendar view of conferences
- `Header` - Navigation and app header

### Data Model
Conferences are defined by the `Conference` interface in `src/types/conference.ts` with properties including:
- Basic info: `title`, `year`, `id`, `full_name`, `link`
- Dates: `deadline`, `abstract_deadline`, `date`, `start`, `end`
- Location: `city`, `country`, `venue`
- Metadata: `tags`, `hindex`, `note`

### Configuration Files
- `vite.config.ts` - Vite configuration with YAML plugin for loading conference data
- `tailwind.config.ts` - Tailwind CSS configuration with custom theme
- `components.json` - shadcn-ui component configuration
- `tsconfig.json` - TypeScript configuration

### Data Updates
Conference data is automatically updated via GitHub Actions workflow (`.github/workflows/update-conferences.yml`) that fetches from ccfddl repository and creates pull requests with updates.

### Path Aliases
- `@/*` maps to `src/*` for cleaner imports

## Development Notes
- The app uses a YAML plugin to import conference data directly in components
- All UI components follow shadcn-ui patterns and conventions
- The project uses React Router for client-side routing
- Date handling uses `date-fns` and `date-fns-tz` for timezone support