generator-sails-rest-api

Stability: 2 - Unstable

The project is in the process of settling, but has not yet had sufficient real-world testing to be considered stable.

Backwards-compatibility will be maintained if reasonable.

Yeoman generator that provides already configured and optimized Sails REST API with bundle of predefined features.

Build Status

Version	Build Status	Coverage Status
Edge (dev)
Stable (master)

Features

Disabled hooks by default: csrf, grunt, i18n, pubsub, session, views;
Overrides default blueprints which simplify CRUD operation in REST API;
Implemented AuthController, PingController and UserController;
Already declared User model with most used fields;
Implemented 2 policies: isAllowed which checks if request is going from our applications, and isAuthenticated which inject user in req via JSON Web Token;
Custom responses which respond with code (Status Code), message (Status Message) and data (Response Data) fields;
Bundle of ready-2-use services like CipherService, PusherService (Push Notifications), SmsService and so on... You can check table with detailed list of implemented services below;
Integrated Passport with Facebook, Twitter, VKontakte, GitHub, Instagram, Google Plus and other social networks, JWT and Local authorization strategies;
All configuration files cleaned up and optimized for REST API;
Winston logger with logging to console and DailyRotateFile is enabled by default;
Bunch of Sails adapters is already declared in connections configuration file so you can easily swap between them;

Getting Started

Start using generator is very simple.

First of all, you need install yeoman and generator-sails-rest-api:

npm install -g yo generator-sails-rest-api

Then create project directory and initiate the generator under the project directory:

mkdir my-project
cd my-project
yo sails-rest-api

You will be prompted for questions. Answer to those questions that generator is asks and you will get configured Sails project.

After scaffolding the project you can use this project as before. Just run the app.js file and all.

node app.js

Congratulations, you just have setup your first Sails REST API 👍

How to use project code?

TODO: Fill with information. But you can read more at our wiki page

Bundled Sails services

All the services is moved to separate npm modules so this table can change through the development process. But I'll try to save it as actual as possible.

Service Name	Implemented providers
CipherService	bcrypt, JWT
MailerService	Mandrill
PaymentService	Stripe
PusherService	Apple Push Notifications, Google Cloud Messaging
SmsService	Twilio
SocialService	Facebook
StorageService	Amazon S3, Google Cloud

How can I get latest dev version of generator?

Right now this generator is extremely under development, so each day our dev branch has new updates and fixes.

If you want get the latest updates, you should do this:

git clone https://github.com/ghaiklor/generator-sails-rest-api.git # Clone the repository
cd generator-sails-rest-api # Change directory
npm link # Link current directory to global module

After that our git repository will be linked to your global npm module and you can use it as described above.

If any updates will come you can just pull the last changes and call generator again:

cd generator-sails-rest-api
git pull
yo sails-rest-api

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

BLamy / generator-sails-rest-api