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.
# Get the latest stable release of Sails $ sudo npm install sails -g
New release available
The v0.11 release of Sails (with support for Socket.io v1.0) is nearly here. You can preview the v0.11 upgrading guide here. To install the beta, run:
sudo npm install -g sails@beta
Upgrading from v0.9?
Be sure and check out the v0.10 upgrading guide.
Your First Sails Project
Create a new app:
# Create the app $ sails new testProject
# cd into the new folder $ cd testProject # fire up the server $ sails lift
Generate a REST API:
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 CouchDB, neDB, TingoDB, SQLite, Oracle, MSSQL, DB2, ElasticSearch, Riak, neo4j, OrientDB, Amazon RDS, DynamoDB, Azure Tables, and RethinkDB; for various 3rd-party REST APIs like Quickbooks, Yelp, and Twitter, including a configurable generic REST API adapter; plus some eclectic projects.
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 suspect an issue in one of Sails sub-modules, you'll usually find its repo on the organization page. Click here to search/post issues in this repository.
See the contribution guide.
Need help or have a question?
Please don't use the issue tracker for support/questions.
|Mike McNeil||Cody Stoltman||Scott Gress||Irl Nathan||Rachael Shaw|
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 :)
MIT License Copyright © 2012-2015 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.