DOFUS PULSE

Advanced Economic Intelligence & Analytics for Dofus Touch

_{Dofus Pulse is a data-driven web application for Dofus Touch, built to provide a comprehensive view of the in-game economy. It combines market analytics, historical price trends, sales performance metrics, profit calculations, gearset planning, and portfolio monitoring, giving players the tools to make informed trading and crafting decisions.}

Run locally · Report Bug · Request Feature

prview.mp4

About this project

I built Dofus Pulse to improve my skills in full-stack development, working on backend technologies like Spring Boot and Java, frontend with TypeScript and React, as well as databases, testing, CI/CD, and infrastructure.

Along the way, I also learned a lot about handling time-series data, performing data-driven calculations, and optimizing queries.

---

🛠 Tech Stack

• Backend: Spring Boot 3.x, Java 21, Maven
• Frontend: React, TypeScript, Vite, TailwindCSS
• Database: PostgreSQL (with TimescaleDB extension to efficiently store and query high-frequency historical market data)

---

✨ Features

Feature	Description	Status
Multi-Item Offer Analysis	Evaluate trade offers containing multiple items by comparing their total market price or crafting cost. Helps quickly analyze trade profitability.	✅ Available
Gearset Management & Cost Planning	Create and manage gear set plans, current item prices, and crafting trends to optimize set acquisition cost.	✅ Available
Market Analytics	Track historical market prices of items, analyze trends, and monitor market activity metrics over time.	✅ Available
Sales Metrics	Analyze item performance on the market: number of items sold, sales volume, listing counts, average sold duration.	✅ Available
Asset Portfolio	Track owned items, acquisition cost, current market value, potential profit/loss, and realized profit/loss.	🚧 Incoming
Price Watcher / Alerts	Create watchlists and alerts for items with specific user-required effects, notifying when items reach target prices or market changes occur.	🚧 Incoming

---

🛠 Prerequisites

• Java 21 – For the Spring Boot backend.
• Node.js & npm – For the React/Vite frontend.
• Docker – Required for Testcontainers and the database.

---

📂 Project Structure

.
├── apps
│   ├── api          # Springboot backend
│   └── web          # React Frontend           
├── env.docker       # Environment variables template
└── docker-compose.yml 

---

🚀 Local Development

1. Database Setup

The backend requires a running database. Start the db service via Docker:

docker compose up -d timescaledb

2. Environment Configuration

The services require environment variables defined in env.docker. Make sure to inject them into your IDE or terminal:

3. Backend (API)

The backend uses Testcontainers . Docker must be running for integrations tests to run correctly.

• OpenAPI: http://localhost:8080/swagger-ui/index.html

cd apps/api
./mvnw spring-boot:run -Dspring-boot.run.profiles=local

4. Frontend

cd apps/web
npm install
npm run dev

---

🐳 docker full setup

To run the entire stack (API + Web + DB) in a containerized environment:

# Start the full stack using the environment file
docker compose --env-file env.docker up --build -d

# Stop and remove containers
docker compose down

---

_{Made with ❤️ for the Dofus Touch community}

_{Dofus Pulse is an independent project, not affiliated with Ankama Games.
DOFUS Touch and ANKAMA are trademarks of Ankama Games. Illustrations are the property of Ankama Studio and Dofus, all rights reserved.}

_{© 2026 Dofus Pulse}