Générateur d'application Express

Utilisez l’outil de générateur d’applications, express-generator, pour créer rapidement un squelette d’application.

Vous pouvez exécuter le générateur d’application avec la commande npx (disponible dans Node.js 8.2.0).

$ npx express-generator

Pour les versions antérieures de Node, installez le générateur d’application en tant que paquet npm global puis lancez le :

$ npm install -g express-generator
$ express

Affiche les options de la commande avec l’option -h:

$ express -h

  Usage: express [options] [dir]

  Options:

    -h, --help          output usage information
        --version       output the version number
    -e, --ejs           add ejs engine support
        --hbs           add handlebars engine support
        --pug           add pug engine support
    -H, --hogan         add hogan.js engine support
        --no-view       generate without view engine
    -v, --view <engine> add view <engine> support (ejs|hbs|hjs|jade|pug|twig|vash) (defaults to jade)
    -c, --css <engine>  add stylesheet <engine> support (less|stylus|compass|sass) (defaults to plain css)
        --git           add .gitignore
    -f, --force         force on non-empty directory

Par exemple, ce qui suit crée une application Express nommée myapp. L’application sera créée dans un dossier nommé myapp dans le répertoire de travail actuel et le moteur de vue sera réglé sur Pug:

$ express --view=pug myapp

   create : myapp
   create : myapp/package.json
   create : myapp/app.js
   create : myapp/public
   create : myapp/public/javascripts
   create : myapp/public/images
   create : myapp/routes
   create : myapp/routes/index.js
   create : myapp/routes/users.js
   create : myapp/public/stylesheets
   create : myapp/public/stylesheets/style.css
   create : myapp/views
   create : myapp/views/index.pug
   create : myapp/views/layout.pug
   create : myapp/views/error.pug
   create : myapp/bin
   create : myapp/bin/www

Installez ensuite les dépendances :

$ cd myapp
$ npm install

Sous MacOS ou Linux, exécutez l’application avec cette commande :

$ DEBUG=myapp:* npm start

Sous l’invite de commande Windows, utilisez cette commande :

> set DEBUG=myapp:* & npm start

Sous Windows PowerShell, utilisez cette commande :

PS> $env:DEBUG='myapp:*'; npm start

Ensuite, chargez http://localhost:3000/ dans votre navigateur pour accéder à l’application.

L’application générée a la structure de répertoire suivante :

.
├── app.js
├── bin
│   └── www
├── package.json
├── public
│   ├── images
│   ├── javascripts
│   └── stylesheets
│       └── style.css
├── routes
│   ├── index.js
│   └── users.js
└── views
    ├── error.pug
    ├── index.pug
    └── layout.pug

7 directories, 9 files

La structure d’application créée par le générateur n’est qu’un des nombreux moyens de structurer les applications Express. N’hésitez pas à utiliser cette structure ou à la modifier pour mieux répondre à vos besoins.