Aurora HomeAurora HomeDocs
DocsInstallation App

Installation de l'application

Guide complet pour installer et configurer l'application web Aurora Home sur votre machine.

Prérequis

Node.js
18 ou supérieur
Git
Dernière version
Un broker MQTT
Mosquitto recommandé
npm ou pnpm
Gestionnaire de paquets
Prisma CLI
Inclus dans les dépendances

Étapes d'installation

1

Cloner le dépôt

Clonez le projet depuis GitHub :

Terminal
git clone https://github.com/antoinegourgue/aurora-home-app.git
cd aurora-home-app
2

Installer les dépendances

Installez toutes les dépendances Node.js :

Terminal
npm install
3

Configurer les variables d'environnement

Créez un fichier .env à la racine du projet :

.env
# Base de données SQLite
DATABASE_URL="file:./dev.db"

# Better Auth — générer avec: openssl rand -hex 32
BETTER_AUTH_SECRET="your-secret-key-here"
BETTER_AUTH_URL="http://localhost:3000"

# Broker MQTT (IP de l'Orange Pi ou du broker)
MQTT_BROKER_URL="mqtt://192.168.4.2:1883"
MQTT_TOPICS="sensor/data"

# Afficheur I2C OTP (optionnel — pour OrangePi 3 LTS)
DISPLAY_OTP_ENABLED="false"
DISPLAY_OTP_I2C_BUS="0"
DISPLAY_OTP_I2C_ADDRESS="0x3C"
DISPLAY_OTP_DEV_MODE="true"

Mode développement

Avec DISPLAY_OTP_DEV_MODE=true, le code OTP s'affiche directement dans le terminal — aucune configuration email nécessaire.

4

Initialiser la base de données

Générez le client Prisma et appliquez le schéma :

Terminal
npx prisma db push

Optionnel — remplir la base avec des données de test :

Terminal
npx tsx prisma/seedFakeData.ts
5

Lancer en développement

Démarrez le serveur de développement Next.js :

Terminal
npm run dev

L'application sera accessible sur http://localhost:3000

Commandes utiles

npm run dev
npm run build
npm start
npm run lint
npm run format
npm run test
npx prisma studio

Vérification

Naviguez sur http://localhost:3000.. Vous devriez voir la page de connexion. Entrez votre email, puis récupérez le code OTP dans le terminal (mode dev).

PrécédentIntroductionSuivantInstallation ESP32