Stargazer

AFK Journey arena simulator built with Vue 3 and TypeScript. Place characters on hex grids and experiment with team compositions.

Features

• Character skills and team synergies
• Drag & drop character placement on hexagonal grid
• Range-aware pathfinding and targeting
• Map editor for custom arenas
• URL-based state sharing
• Responsive design seamlessly adapts to mobile, tablet, and desktop

Quick Start

Prerequisites: Node.js 22+, Git

git clone <repository-url>
cd stargazer
npm install
npm run dev

Open http://localhost:5173

Commands

npm run dev         # Start development server
npm run build       # Production build
npm run test        # Run tests

See Contributing for all available commands.

Project Structure

├── src/                # Source code
│   ├── lib/            # Domain logic
│   ├── stores/         # State management
│   ├── components/     # Vue components
│   ├── views/          # Page views
│   ├── data/           # Static data
│   └── assets/         # Images & styles
├── test/               # Test files
└── docs/               # Documentation

Documentation

Core:

• Getting Started - Setup guide
• Architecture - System design

Systems:

• Grid & Characters
• Skills
• Pathfinding
• Drag & Drop
• Event System
• Map Editor
• URL Serialization

Contributing

See Getting Started for setup and guidelines.

---

Built with the help of Claude Code 🤖⚔️