Maintainer: Rui Ferrão

Extremely opinionated Hapi boilerplate using a layered architecture for proper separation of concerns

WARNING: Noire is currently under active development and might not be ready for heavy production use

• Accept data
• Apply style and formatting
• Rendering

• Map routes
• Extract route parameters
• Kick off some work
• Send the result to a View for rendering

• Perform work for the Controller
• Return the result for the Controller

• Repository pattern for data entities
• Thin models
• ORM with transactional capabilities

• HTTP and HTTPS support
• Server rendered views using the Semantic-UI front-end framework and Handlebars template engine
• API routes for rendering on the client side and building SPAs
• Automated API documentation generation
• Stateless JWT auth for API endpoints
• Cookie stored JWT auth for web app with CSRF protection
• RBAC authorization
• AJAX login, signup, registration and password reset forms
• Email sending using handlebars templates
• Client side caching of assets
• Fast and flexible logging (Pino)
• Testing, code coverage and Travis CI integration
• Graceful server shutdown
• Database ORM (Objection) with migrations (Knex) support
• Usage of native Promises and async/await

git clone [email protected]:academia-de-codigo/noire-server.git

npm install

Edit all lib/config* files

• NODE_ENV should be set to either development, staging or production. If not set at all, defaults to development
• JWT_SECRET should contain a secret which will be used to sign authentication tokens. A safe randomly generated secret can be obtained by running npm run secret.
• SMTP credentials should be configured using the SMTP_USER and SMTP_PASS environment variables
• Staging and Production environment need the DB_HOSTT, DB_NAME, DB_USER and DB_PASS environment variables for configuration the database connection
• All environment variables can be setup inside a .env file which should not be commited and is sourced when the server starts. A sample example.env file is provided.

npm run reset

npm run build

npm test

• Make sure NODE_ENV=production
• Update frontend build running npm run webpack:prod
• Start the server with npm start

• Set NODE_ENV=development
• Update frontend build running npm run webpack
• Start the server in watch mode with npm run watch

Noire is developed using Vim and Visual Studio Code. With VSCode the following plugins are used:

• Babel ES6/ES7
• Document This
• DotENV
• EditorConfig for VS Code
• ESLint
• HTMLHint
• Node.js Modules Intellisense
• npm
• Path Autocomplete
• Prettier

For proper code formatting and module intellisense under VSCode, the following settings are recommended:

"settings": {
		"editor.formatOnSave": true,
		"node-module-intellisense.scanBuiltinModules": true,
		"node-module-intellisense.scanDevDependencies": true,
		"node-module-intellisense.scanFileModules": true,
		"node-module-intellisense.modulePaths": [
			"lib"
		],
		"node-module-intellisense.autoStripExtensions": [
			".js"
		]
	}