Krys4lide/crates/app/README.md

Pré-requis

• Récupérer le binaire TailwindCSS : https://tailwindcss.com/blog/standalone-cli

Configuration

Astuce : lorsqu'on exécute directement la crate App à des fins de développement, le système de configuration n'utilisera pas l'éventuel fichier .env situé à la racine du workspace Rust. Pour éviter de dupliquer le fichier .env, il est possible de créer un lien symbolique vers le fichier .env de la crate App :

cd crates/app
ln -s ../../.env .env

Exécution

• Lancer tailwindcss en mode watch dans un terminal :

./tailwindcss -i css/input.css -o assets/css/style.css --watch

• Lancer le serveur web dans un autre terminal :

cargo run --bin app

Rechargement automatique (auto-reload)

Pour le projet app, nous utilisons en plus de cargo-watch ses librairies :

• systemfd permet de redémarrer un serveur sans interrompre les connexions en cours, il transmet le descripteur de fichier du socket à une nouvelle instance du serveur (exemple: cargo watch -x run --> systemfd --no-pid -s http::3000 -- cargo watch -x run). Si le port est déjà pris il en prendra un autre.
• listenfd permet, côté Rust, de démarrer un serveur en utilisant des connexions déjà ouvertes.

Pour notre application voici la commande à lancer :

systemfd --no-pid -s http::3000 -- cargo watch -x 'run --bin app'

Chargement à chaud (livereload)

Pour que notre navigateur rafraîchisse automatique notre page lorsque le serveur a été recompilé, nous utilisons la librairie tower-livereload.

A chaque changement, que ça soit sur du code en Rust, HTML, CSS ou JS alors le navigateur va recharger entièrement la page.

En Rust, il n'existe pas encore d'outil de Hot Reload complet et intégré comme on en trouve dans d'autres environnements de développement web, comme pour Node.js.