Sails.js is a web framework that makes it easy to build custom, enterprise-grade Node.js apps. It is designed to resemble the MVC architecture from frameworks like Ruby on Rails, but with support for the more modern, data-oriented style of web app & API development. It's especially good for building realtime features like chat.
# Get the latest stable release of Sails $ npm install sails -g
######Upgrading from an earlier version of Sails? Version migration guides for all major releases since 2013 are available on the Sails website under Upgrading.
Your First Sails Project
Create a new app:
# Create the app $ sails new my-app
# cd into the new folder $ cd my-app # fire up the server $ sails lift
Generate a REST API:
For the most up-to-date introduction to Sails, get started here.
Sails actions are compatible with Connect middleware, so in most cases, you can paste code into Sails from an existing Express project and everything will work-- plus you'll be able to use WebSockets to talk to your API, and vice versa.
The ORM, Waterline, has a well-defined adapter system for supporting all kinds of datastores. Officially supported databases include MySQL, PostgreSQL, MongoDB, Redis, and local disk / memory. Community adapters exist for CouchDB, neDB, TingoDB, SQLite, Oracle, MSSQL, DB2, ElasticSearch, Riak, neo4j, OrientDB, Amazon RDS, DynamoDB, Azure Tables, RethinkDB and Solr; for various 3rd-party REST APIs like Quickbooks, Yelp, and Twitter, including a configurable generic REST API adapter; plus some eclectic projects.
For the latest core adapters and notable community adapters, see Available Adapters.
- Sails.js in Action by Mike McNeil and Irl Nathan (Manning Publications).
- Sails.js Essentials by Shaikh Shahid (Packt)
- Pro Express.js: Part 3 by Azat Mardan (Apress).
Need help or have a question?
There are many different ways you can contribute to Sails:
- answering questions on StackOverflow, Gitter, IRC, Facebook, or Twitter
- improving the documentation or website
- translating the documentation to your native language
- writing tests
- writing a tutorial, giving a talk, or supporting your local Sails meetup
- troubleshooting reported issues
- and submitting patches.
Sails is actively maintained with the help of many amazing contributors. Our core team consists of:
|Mike McNeil||Cody Stoltman||Scott Gress||Irl Nathan||Rachael Shaw|
The Sails Company designs/builds scalable Node.js apps for startups and enterprise customers. After building a few applications and taking them into production, we realized that the Node.js development landscape was very much still the Wild West. Over time, after trying lots of different methodologies, we decided to crystallize all of our best practices into this framework. Five years later, Sails is now one of the most widely-used web application frameworks in the world. I hope it saves you some time! :)
MIT License Copyright © 2012-2017 Mike McNeil, Balderdash Design Co., & The Sails Company