NodeTyped

A Node.js starter kit featuring ES6 with Secuential Asynchrony (async/await), Express (Routing middlewares, Web, Api), Typescript, Mongoose, MongooseClass, SCSS, EJS, Nodemon, Bootstrap 4, TSLint, Jasmine, JsDoc, .

• Simple npm setup and maintenance, without grunt/gulp/webpack/...

• Support for async/await

Example middleware:

1async function(req, res, next) {
2    let title = 'NodeTyped Express';
3    try {
4        let data = await readFile(file, 'utf-8'); // no callbacks!
5        res.render('index', { title: title, dump: data });
6    } catch (e) {
7        next(e);
8    }
9}

Example model:

1@Model({})
2export class User extends MongooseModel {
3
4    @Column({ type: String, index: true })
5    name: string;
6
7    @Column(Number)
8    age: number;
9
10    static list(): Promise<any> {
11        return this.find().exec();
12    }
13
14    greet() {
15        return `Hello I'm ${this.name}`;
16    }
17
18}

Requirements

Make sure you have node version >= 4.0

Clone and Install dependencies

1# clone the repo
2# --depth 1 removes all but one .git commit history
3git clone --depth 1 https://github.com/jamg44/NodeTyped.git projectname
4
5# change directory to your new project
6cd projectname
7
8# install the repo dependencies with npm
9npm install
10
11# start the server
12npm run dev

If you want to use mongoose models, start mongodb, check localConfig.js and:

1# load sample products in database (defaults to 'test')
2npm run loadMocks

Develop

Watch mode

You can start the server in development mode (linter included) with:

1npm run dev

Open the browser at:

• http://localhost:3000

Start MongoDB, run 'npm run loadMocks', and check:

• http://localhost:3000/products
• http://localhost:3000/apiv1/products
• http://localhost:3000/apiv1/products/near/(meters)/lon/(lon)/lat/(lat)

As you save in your editor, the compiler will rebuild and restart the server.

Other commands

Run the linter manually:

1npm run lint

Clean temp folders:

1npm run clean

Run the tests:

1npm test

Generate docs, the output will be in /doc folder:

1npm run doc

Production / Integration

To run the project in a server you'll want to run the built code instead src version.

1# deploy the repo to server and run
2npm install
3npm start

Recommendations

• When requiring from node_modules you must use require:

1// require from /node_modules
2let express = require('express');

• With other module types you can use import (node api, created modules):

1import * as fs from 'fs';
2import { findConfigFile } from '../lib/utils';

• To change project name update package.json

1"name": "project_name", <-----
2...
3"dev": "tsc && DEBUG=project_name2:* ... <-----

• All your reusable functions must return promises for better use with async/await.

1let readFile = function(file, encoding) => {
2    return new Promise((resolve, reject) => {
3        fs.readFile(file, encoding, function(err, data) {
4            if (err) {
5                return reject(err);
6            }
7            resolve(data);
8        });
9    });
10};

Roadmap (TODO)

• API authentication with JWT
• Add SSL
• Add cluster
• User system (register, login, etc)
• Add sequelize
• Add test coverage report
• Yeoman
• Basic panel

License

MIT

Made with ♡ by Javier Miguel González @javiermiguelg