express-demo

0.0.1 • Public • Published

Express Demo Logo

Express app example.

Motivation

When I began an project personal, I had very problems for integrate diferents modules for login, i18n, send email, ORM, test unit, enviroment variables, generate documentation, minified files, check code format and syntax, etc.

Finally I could it solutions reviewing documentation officials, GitHub, StackOverflow and differents web site.

I hope that this example or part of it to be util for the community.

Sure that this example could improve and to be complete with more functionality. Are welcome suggestions, ideas, bugs identified, and colaborations. Greetings!

Live demo

Included modules

Modules dev

Requeriments

Enviroment

Installation

$ npm install express-demo

Configuration

Create a file .env based on .env.example and add settings:

  • Port.
  • Name app.
  • Database.
  • Session.
  • Bcrypt salt.
  • Email.
  • Login social (Optional).

Quick Start

The scripts is configured in the file package.json

"scripts"{
    "start""node ./bin/www",
    "start-dev""NODE_ENV=development node ./bin/www",
    "test""NODE_ENV=development mocha ./test/*.js"
},

For to start the server for development enviroment:

$ npm run start-dev

And to run the test suite on development enviroment:

Note: First must edit the file test/util/data-test.js putting your test data.

$ npm test

Run Grunt local (Default)

node_modules/.bin/grunt

Run Grunt global (Optional)

First install globaly:

sudo npm i -g grunt-cli

Then to call Grunt is grunt directly.

Note: This too can considered for: sequelize-cli

Features

  • Login on form.
  • Login with Google, Facebook and Twitter. (Optional)
  • Signup.
  • Forgot password.
  • i18n.

Features dev

Note: Considering Grunt global for simplicity.

  • Unit test.
  • Generate documentation: grunt jsdoc. Documentation generated in doc folder.
  • Check format and syntax code: grunt exec:eslint. If exists erros, look log/eslint.log file
  • Minimize public/js/general.js file: grunt exec:minGeneral. File generated: public/js/general.min.js
  • Minimize public/css/main.css file: grunt cssmin. File generated: public/css/main.min.js

Or only grunt for run all tasks. Look Gruntfile.js for more details.

Social login (Optional)

Create an app on Google, Facebook or Twitter and set in the file .env

For example for Facebook:

FB_ID=YourFacebookAppID
FB_SECRET=YourFacebookAppSecret
FB_SCOPE=email
FB_CALLBACK=http://localhost:3000/auth/facebook/callback

For reduce code, others callbacks follow same patter. For example:

FB_CALLBACK=http://localhost:3000/auth/facebook/callback
GG_CALLBACK=http://localhost:3000/auth/google/callback
TW_CALLBACK=http://localhost:3000/auth/twitter/callback

People

Author: alditis

If this project help you some and you want support me, you can give me a donate. Thanks!

Liberapay Donate     Paypal Donate     Bitcoin Donate

License

MIT

Package Sidebar

Install

npm i express-demo

Weekly Downloads

10

Version

0.0.1

License

MIT

Last publish

Collaborators

  • alditis