vngeoguessr/CLAUDE.md

CLAUDE.md

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

Documentation

For detailed information about this project, refer to the documentation files in /docs/:

• Project Overview - Project summary, key characteristics, and game mechanics
• Features - Detailed game features, scoring system, and security measures
• Tech Stack - Complete technology stack and dependencies
• Development Guidelines - Development commands, coding standards, and best practices
• Game Flow - Complete gameplay flow from start to finish
• Project Structure - Directory organization and file purposes

Quick Reference

Development Commands:

• npm run dev - Start development server with Turbopack
• npm run build - Build the application for production
• npm start - Start production server
• npm run lint - Run ESLint

Key Guidelines:

• JavaScript Only: No TypeScript files (.ts, .tsx)
• Function Parameters: Use individual parameters, not object destructuring
• File Modifications: Only modify source code, /docs, and /plans
• Security: Never expose secrets or keys
• Testing: Inform user when complete - they handle manual testing

Critical Instructions

When working on this codebase, always:

1. Read the relevant documentation files in /docs/ for context
2. Follow the JavaScript-only approach with individual function parameters
3. Maintain server-side security for game sessions and coordinates
4. Use existing patterns and libraries already present in the codebase
5. Highlight any configuration file changes for manual processing