sails

Website   Getting Started   Documentation   Submit Issue

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 development. It's especially good for building realtime features like chat.

Installation  

With node installed:

# Get the latest stable release of Sails
$ sudo npm install sails -g

######Installing sails@beta Associations support in Sails is finally here. Ready to upgrade? v0.10 is still in beta, but the API has stabilized and now's a good time to start upgrading. Check out the Google group announcement and/or the relevant sections of the FAQ and contribution guide for instructions and tips.

Your First Sails Project

Create a new app:

# Create the app
$ sails new testProject

Lift sails:

# cd into the new folder
$ cd testProject

# fire up the server
$ sails lift

Generate a REST API:

Compatibility

Sails is built on Node.js, Connect, Express, and Socket.io.

Sails controllers 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, local disk, and local memory. Community adapters exist for Riak, CouchDB, Oracle, MSSQL, RethinkDB, and ElasticSearch; for various 3rd-party REST APIs like Yelp and Twitter; plus some eclectic projects.

                               

Issue Submission

Make sure you've read the issue submission guidelines before opening a new issue.

Sails is composed of a number of different sub-projects, many of which have their own dedicated repository. If you are looking for a repo for a particular piece, you'll usually find it on the organization page.

Feature Requests

See the Trello board to view/discuss our roadmap and request features.

Contribute

See the contribution guide.

Support

Need help or have a question?

• Tutorials
• Stackoverflow
• #sailsjs on Freenode (IRC channel)
• Professional/Enterprise Options

Please don't use the issue tracker for support/questions.

Links

• Website
• Official Documentation
• Changelog
• Roadmap
• Google Group
• Twitter
• SailsCasts

Team

Sails is actively built and maintained by Balderdash (@balderdashy), a realtime web & mobile studio, with the help of these contributors:

Mike McNeil	Cody Stoltman	Scott Gress	Greg Thornton	Zoli Kahan

Balderdash designs/builds scalable Node.js apps for startups and enterprise customers. After building a few apps 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. I hope it saves you some time :)

License

MIT License Copyright © 2012-2014 Mike McNeil

Sails is built around so many great open-source technologies that it would never have crossed our minds to keep it proprietary. We owe huge gratitude and props to TJ Holowaychuk (@visionmedia) and Guillermo Rauch (@guille) for the work they did, as well as the stewards of all the other open-source modules we use. Sails could never have been developed without your tremendous contributions to the node community.