git:20250712.06b5aff to git:20250826.89d9624

# CLAUDE.md

This repository contains the website, documentation and changelog of the software Langfuse (https://langfuse.com).

## Development Commands

### Core Development

- `pnpm dev` - Start development server on localhost:3333

- `pnpm build` - Build the production version

- `pnpm start` - Start production server on localhost:3333

### Content Management

- `pnpm run prebuild` - Updates GitHub stars and generates contributor data (runs automatically before build)

- `bash scripts/update_cookbook_docs.sh` - Convert Jupyter notebooks to markdown (uses uv with inline dependencies)

- `pnpm run link-check` - Check for broken links in documentation

### Analysis

- `pnpm run analyze` - Analyze bundle size using @next/bundle-analyzer

## Architecture Overview

This is a **Nextra-based documentation site** for Langfuse built with Next.js. Key architectural components:

### Technology Stack

- **Nextra** (3.0.15) - Documentation framework built on Next.js

- **Next.js** (15.2.4) - React framework

- **shadcn/ui** - UI component library with semantic color tokens

- **Tailwind CSS** - Styling (always use semantic color tokens, never explicit colors)

- **TypeScript** - Type safety

- **pnpm** - Package manager (v9.5.0)

### Content Architecture

- **MDX/Markdown Pages**: `/pages/` - All documentation content

- **Components**: `/components/` - React components including custom MDX components

- **Cookbook**: `/cookbook/` - Jupyter notebooks converted to markdown

- **Static Assets**: `/public/` - Images, icons, and other static files

### Key Directories

- `components/` - Reusable React components

- `pages/` - All site pages (docs, blog, changelog, FAQ)

- `cookbook/` - Jupyter notebooks (Python/JS) that get converted to markdown

- `components-mdx/` - MDX components used across pages

- `scripts/` - Build and maintenance scripts

- `lib/` - Utility functions and configurations

### Content Management Workflow

1. **Jupyter Notebooks**: Edit `.ipynb` files in `/cookbook/`

2. **Conversion**: Run `bash scripts/update_cookbook_docs.sh` to convert to markdown (uses uv automatically)

3. **Location**: Generated markdown files are placed in `/pages/guides/cookbook/`

4. **Important**: Never edit generated `.md` files directly - always edit the source notebooks

### Key Configuration Files

- `next.config.mjs` - Next.js configuration with extensive redirects

- `theme.config.tsx` - Nextra theme configuration

- `components.json` - shadcn/ui configuration

- `tailwind.config.js` - Tailwind CSS configuration

### Styling Guidelines

- Use semantic color tokens from shadcn/ui, never explicit colors

- Components follow shadcn/ui patterns and conventions

- Responsive design with mobile-first approach

### Content Types

- **Documentation**: `/pages/docs/` - Technical documentation

- **Blog**: `/pages/blog/` - Blog posts with MDX

- **Changelog**: `/pages/changelog/` - Product updates

- **Cookbook**: `/pages/guides/cookbook/` - Generated from Jupyter notebooks

- **FAQ**: `/pages/faq/` - Frequently asked questions

### Development Notes

- Development server runs on port 3333 (not standard 3000)

- Uses pnpm as package manager

- Auto-generates contributor data and GitHub stars before builds

- Extensive redirect configuration for URL management

- CSP headers configured for security in production