Pooly

🇫🇷 Journal d'entretien pour piscines et spas — self-hosted 🇬🇧 Pool & spa maintenance tracker — self-hosted

• Présentation
• Fonctionnalités
• Screenshots
• Installation rapide
• Configuration
• Stack technique
• Contribuer
• Licence

Pooly est une application web self-hosted pour suivre l'entretien de vos piscines et spas. Enregistrez vos mesures, traitements et entretiens depuis un dashboard clair — vos données restent chez vous.

Conçu pour les propriétaires qui veulent garder le contrôle sans complexité : une commande Docker et c'est lancé.

• Dashboard complet — KPIs, paramètres en temps réel, indicateur visuel de l'état de l'eau
• Saisie par bandelette AquaChek — nuancier interactif pour pH, TAC, Brome et Dureté
• Saisie par appareil numérique — inputs décimaux avec validation des plages
• Multi-installation — gérez plusieurs piscines et spas avec des plages de référence adaptées
• Piscine & Spa — brome ou chlore, plages idéales différenciées
• Historique complet — timeline groupée par mois, filtres par type, recherche full-text
• Page Mesures — suivi de l'évolution des paramètres dans le temps
• Mode sombre — thème clair, sombre ou automatique (préférence système)
• PWA — installable sur mobile, bottom navigation, bottom sheet modal
• Self-hosted & privé — aucun cloud tiers, aucun tracking, vos données restent chez vous

Journal — Mode clair	Journal — Mode sombre

Mesures	Historique

Nouvelle entrée — Entretien	Nouvelle entrée — Bandelette AquaChek

Prérequis : Docker et Docker Compose installés sur votre machine.

# 1. Clonez le dépôt
git clone https://github.com/aurel-f/pooly.git
cd pooly

# 2. Configurez l'environnement
cp .env.example .env
nano .env  # Définissez vos mots de passe et secrets

# 3. Lancez Pooly
docker compose up -d

# 4. Ouvrez dans votre navigateur
open http://localhost:8090

L'application est accessible sur http://localhost:8090. Créez votre compte à la première connexion.

Copiez .env.example en .env et ajustez les valeurs :

⚠️ Ne jamais committer votre fichier .env. Il est déjà dans le .gitignore.

Les contributions sont les bienvenues ! Voici comment participer :

# Forkez le repo, puis :
git clone https://github.com/aurel-f/pooly.git
cd pooly
git checkout -b feature/ma-fonctionnalite

# Faites vos modifications, puis :
git commit -m "feat: description de la fonctionnalité"
git push origin feature/ma-fonctionnalite
# Ouvrez une Pull Request

Types de contributions appréciées :

• 🐛 Corrections de bugs
• ✨ Nouvelles fonctionnalités
• 🌍 Traductions
• 📸 Screenshots et démos
• 📖 Améliorations de la documentation

Consultez les issues ouvertes pour voir ce sur quoi travailler.

Distribué sous licence MIT. Voir LICENSE pour plus d'informations.

• Overview
• Features
• Screenshots
• Quick start
• Configuration
• Tech stack
• Contributing
• License

Pooly is a self-hosted web application to track the maintenance of your pools and spas. Log your water measurements, treatments and maintenance tasks from a clean dashboard — your data stays on your own server.

Designed for owners who want full control without complexity: one Docker command and you're up and running.

• Full dashboard — KPIs, real-time water parameters, visual water quality indicator
• AquaChek test strip input — interactive color chart for pH, Alkalinity, Bromine and Hardness
• Digital device input — decimal inputs with range validation
• Multi-installation — manage multiple pools and spas with adapted reference ranges
• Pool & Spa — bromine or chlorine, differentiated ideal ranges
• Full history — monthly timeline, type filters, full-text search
• Measurements page — track parameter trends over time
• Dark mode — light, dark or automatic theme (system preference)
• PWA — installable on mobile, bottom navigation, bottom sheet modal
• Self-hosted & private — no third-party cloud, no tracking, your data stays yours

See screenshots in the French section above.

Requirements: Docker and Docker Compose installed on your machine.

# 1. Clone the repository
git clone https://github.com/aurel-f/pooly.git
cd pooly

# 2. Set up environment
cp .env.example .env
nano .env  # Set your passwords and secrets

# 3. Start Pooly
docker compose up -d

# 4. Open in your browser
open http://localhost:8090

The app is available at http://localhost:8090. Create your account on first login.

Copy .env.example to .env and adjust the values:

⚠️ Never commit your .env file. It is already in .gitignore.

Contributions are welcome! Here's how to get involved:

# Fork the repo, then:
git clone https://github.com/aurel-f/pooly.git
cd pooly
git checkout -b feature/my-feature

# Make your changes, then:
git commit -m "feat: describe the feature"
git push origin feature/my-feature
# Open a Pull Request

Appreciated contribution types:

• 🐛 Bug fixes
• ✨ New features
• 🌍 Translations
• 📸 Screenshots and demos
• 📖 Documentation improvements

Check the open issues to find something to work on.

Distributed under the MIT License. See LICENSE for more information.