DocsUnité 1 : les bases
Créer une application de notes avec Nexy, partie 1 : créer le projet
La première partie du didacticiel crée le projet que vous allez transformer en une application de notes et l'exécute dans votre navigateur en cinq minutes environ.
Avant de commencer : uv et Node.js 20 ou plus récent. Le tutoriel suit le routeur choisi en haut du menu : basculez-le là et chaque partie montre les fichiers de ce routeur.
Ce que vous construirez
À la fin du didacticiel, l'application comporte des pages et une API JSON pour les notes, une base de données, des comptes, des notes partagées par e-mail, des mises à jour en direct, des tests et une version de production. Chaque partie se termine par une application qui s'exécute, vous pouvez donc vous arrêter après n'importe laquelle d'entre elles.
Créer le projet
uvx nexy new notes
Répondez aux questions de cette façon :
| Question | Réponse |
|---|---|
| Routeur basé sur des fichiers ? | Yes pour les routeurs basés sur des fichiers et personnalisés, No pour le routeur modulaire |
| Type de projet | Web |
| Routage côté client | No : le serveur restitue les pages |
| Cadre client | React : il revient dans l'unité 4, pour les îles |
| Style | Tailwind CSS |
| Importer un alias | @ |
| ORM | No database : la partie 5 en ajoute un |
Le routeur personnalisé est celui basé sur un fichier plus un APIRouter que vous possédez déjà. Le didacticiel crée l'application avec des fichiers ; Inclure un FastAPI routeur existant montre comment monter le vôtre à côté d'eux.
Exécutez-le
cd notessource .venv/bin/activate # Windows: .venv\Scripts\activatenexy dev
Ouvrez http://localhost:3000. Vous devriez voir la page d'accueil. Laissez nexy dev tourner : désormais, chaque fichier que vous enregistrez recharge le navigateur.
Ce que tu as appris
uvx nexy newcrée un projet et installe ses packages Python et JavaScript.nexy devle sert et recharge lors de la sauvegarde.
- Les pages vivent dans
src/routes/: la partie suivante en ajoute une.
- Les contrôleurs et leurs vues vivent dans
src/apps/: la partie suivante en ajoute une.
Prochaines étapes
- Partie 2 : pages et mises en page
- Structure du projet : à quoi sert chaque fichier du projet