# Silksong Interactive Map - LLM.txt

## Project Overview
This is an interactive map for Hollow Knight: Silksong, built to help players navigate the world of Pharloom and track collectibles, bosses, tools, and points of interest across all areas.

## Technology Stack
- **Frontend**: Next.js 14 with React and TypeScript
- **Mapping**: Leaflet.js for interactive map functionality
- **Styling**: Tailwind CSS for responsive design
- **State Management**: Client-side localStorage for progress tracking
- **Deployment**: Serverless architecture (no backend required)

## Project Structure
```
src/
├── app/
│   ├── components/          # Reusable React components
│   │   ├── Navigation.tsx   # Main navigation with map dropdown
│   │   ├── MapViewer.tsx    # Interactive map component
│   │   ├── Footer.tsx       # Site footer
│   │   └── ...
│   ├── maps/               # Individual map pages
│   │   ├── bellhart/       # Hub town area
│   │   ├── choral-chambers/ # Musical Citadel area
│   │   ├── cogwork-core/   # Mechanical challenges
│   │   ├── deep-docks/     # Lava forge industrial
│   │   ├── grand-gate/     # Citadel entrance
│   │   ├── greymoor/       # Tower region
│   │   └── ...
│   ├── globals.css         # Global styles
│   └── layout.tsx          # Root layout
├── data/
│   ├── categories.ts       # POI category definitions
│   └── pois.ts            # Points of interest data
public/
├── data/
│   ├── areas.json         # Area definitions
│   ├── pois.json          # POI locations and metadata
│   └── ...
└── sitemap.xml           # SEO sitemap
```

## Key Features
- **Interactive Map**: Leaflet-based map with zoom, pan, and marker functionality
- **POI Filtering**: Collapsible category system with 280+ points of interest
- **Progress Tracking**: Local storage for marking completed items
- **Spoiler Protection**: Area-based content filtering
- **Mobile Responsive**: Optimized for all device sizes
- **SEO Optimized**: Individual pages for each area with structured data

## Data Structure
- **Areas**: Geographic regions with boundaries and connections
- **POIs**: Points of interest including bosses, tools, collectibles, benches
- **Categories**: Organized groupings (Collectibles, Tools & Items, Facilities, Creatures, Resources)

## Development Guidelines
- All map pages follow consistent layout patterns
- SEO titles kept under 60 characters
- Meta descriptions under 160 characters
- Keyword density maintained at 0.025-0.035 for "silksong [area] map"
- Content length 1000-1500 words per area page

## Content Areas Covered
1. **Bellhart** - Cursed hub town with Widow boss
2. **Choral Chambers** - Musical Citadel with melody puzzles
3. **Cogwork Core** - Mechanical challenges and Architect's Melody
4. **Deep Docks** - Industrial lava forge with Swift Step ability
5. **Grand Gate** - Monumental Citadel entrance and Act 2 transition
6. **Greymoor** - Massive tower region with Moorwing boss
7. **Putrified Ducts** - Hidden toxic area
8. **And many more...**

## API Endpoints
This is a static site with no backend APIs. All data is loaded from JSON files in the public directory.

## Contribution Guidelines
- Follow existing code patterns and component structure
- Maintain SEO optimization standards
- Test on mobile devices
- Ensure accessibility standards
- Use TypeScript for type safety

## License
This project is a fan-made tool for Hollow Knight: Silksong and is not affiliated with Team Cherry.

## Contact
For issues or feature requests, please use the GitHub repository issue tracker.

## Last Updated
2025-09-23

---
This file provides context for AI assistants working with this codebase.