# ⚓ Harbour Heaven

Harbour Heaven is a strategic idle harbour management game built with Flutter.

The game focuses on long-term planning, calculated risk, and passive progression. Players expand their harbour, manage fleets, send voyages, and grow their economy through strategic decisions rather than constant interaction.

---

## 📌 Overview

Harbour Heaven is designed as a slow-paced strategic experience where:

- Players check in once or twice per day
- Decisions have long-term consequences
- Risk vs reward is central to progression
- Growth comes from planning, not grinding

---

## 🚢 Core Gameplay Systems

### Voyages
- Send ships on expeditions to gather resources
- Each voyage carries risk
- Ships may return with profit
- Ships may be lost
- Preparation increases success chances

### Ships & Strategy
- Ships are core economic assets
- Different ship types provide different advantages
- Larger fleets increase potential reward
- Larger fleets increase potential risk

### 🏭 Production
- Buildings generate passive income
- Upgrades increase efficiency
- Production enables long-term scaling

---

## 🏗 Architecture & Tech Stack

Built using:

- Flutter
- Dart
- Riverpod (state management)
- Component-based UI architecture
- Modular game logic structure

Project structure overview:

```
lib/
 ├── components/
 ├── data/
 │    ├── model/
 │    ├── providers/
 │    ├── hive/
 ├── pages/
 ├── views/
 └── main.dart
```

The architecture separates UI, state management, and business logic to ensure scalability and maintainability.

---

## 🎯 Design Goals

- Clean and readable codebase
- Maintainable architecture
- Strategic idle gameplay
- Expandable game systems
- Consistent UI design

---

## 🧪 Project Status

⚠️ Harbour Heaven is currently in beta.

Game systems, balance, and mechanics may change during development.

---

## 🤖 AI Usage Disclosure

Artificial Intelligence tools (including large language models) were used during development for:

- Improving text clarity and documentation
- Refining UI descriptions
- Fixing minor non-critical bugs
- Code explanation and learning support

All architectural decisions, gameplay systems, and core implementation were designed and written by the project author.

AI tools were used strictly as development assistance and not as a replacement for core development work.