Skip to content

Files

Latest commit

 

History

History
244 lines (131 loc) · 24.4 KB

MODULES.md

File metadata and controls

244 lines (131 loc) · 24.4 KB

Modules

Sails is a large project, with many modular components. Each module is located in its own repository, and in most cases is tested individually.

Below, you'll find an overview of the modules maintained by the core team and community members.

Sails core

The modules comprising the Sails framework, as well as the other plugins maintained by our core team, are spread across a number of different code repositories. Some modules can be used outside of the context of Sails, while others are not intended for external use.

Framework and ORM

For more information on the available releases of the Sails framework as a whole, check out the contribution guide.

Package Latest Stable Release Build Status (edge)
Sails.js logo (small) NPM version Build Status
Waterline logo (small) NPM version Build Status

Core hooks

As of Sails v1, some hooks are no longer included in Sails core. Instead, they're published as standalone packages:

Hook Package Latest Stable Release Build Status (edge) Purpose
orm sails-hook-orm NPM version Build Status Implements support for Waterline ORM in Sails.
sockets sails-hook-sockets NPM version Build Status Implements Socket.io support in Sails.

These are not all the core hooks in Sails. There are other core hooks built in to the sails package itself (see lib/hooks/). These other, built-in hooks can still be disabled or overridden using the same configuration.

Bundled hooks

Certain additional hooks are bundled as dependencies of a new Sails app, especially when using the "Web app" template:

Hook Package Latest Stable Release Build Status (edge) Purpose
grunt sails-hook-grunt NPM version Build Status Governs the built-in asset pipeline in Sails.
organics sails-hook-organics NPM version Build Status Evolving library of well-tested, well-documented, and officially supported modules for the most common everyday tasks in apps (e.g. password hashing, emails, billing, etc.)
apianalytics sails-hook-apianalytics NPM version Build Status A Sails hook for logging detailed request metadata and monitoring your API.
dev sails-hook-dev NPM version Build Status A Sails hook that provides diagnostic / debugging information and levers during development.

Core socket client SDKs

Platform Package Latest Stable Release Build Status (edge)
Browser sails.io.js-dist NPM version Build Status
Node.js sails.io.js NPM version Build Status

Other browser libraries

The "Web App" template in Sails comes with a lightweight client-side JavaScript wrapper for Vue.js called parasails:

NPM version

Core database adapters

Package Latest Stable Release Build Status (edge) Platform
sails-disk NPM version Build Status Local disk (.tmp/)
sails-mysql NPM version Build Status MySQL
sails-postgresql NPM version Build Status PostgreSQL
sails-mongo NPM version Build Status MongoDB
sails-redis NPM version Build Status Redis

Core filesystem adapters

Package Latest Stable Release Build Status (edge) Platform
skipper-disk NPM version Build Status Local disk (.tmp/uploads/)
skipper-s3 NPM version Build Status Amazon S3 (AWS)

Core generators

As of Sails v1.0, core generators are now bundled in sails-generate. All generators can still be overridden the same way. For examples, see below.

Core framework utilities

Package Latest Stable Release Build Status (edge)
skipper NPM version Build Status
machine NPM version Build Status
machine-as-action NPM version Build Status
whelk NPM version Build Status
captains-log NPM version Build Status
anchor NPM version Build Status
sails-generate NPM version Build Status
waterline-schema NPM version Build Status
waterline-utils NPM version Build Status
include-all NPM version Build Status
reportback NPM version n/a
switchback NPM version Build Status
rttc NPM version Build Status
@sailshq/lodash npm version n/a

Forks

Official documentation

The official documentation for the Sails framework is written in Markdown, and is automatically compiled for the Sails website.

Repo Purpose
sails-docs Raw content for reference, conceptual, anatomical, and other documentation on the Sails website (in Markdown).
www.sailsjs.com The Sails app that powers sailsjs.com. HTML content is automatically compiled from sails-docs.
doc-templater The module we use to pre-process, compile, and format Markdown documentation files into the HTML markup and tree menus at sailsjs.com/documentation.

All known translation projects for the Sails documentation are listed in the README sails-docs.

Community projects

In addition to the official code repositories that are supported by the Sails.js core team, there are countless other plugins created by members of the Sails.js community.

Hooks

There are at least 200 community hooks for Sails.js available on NPM.

Learn about custom hooks in Sails.

Asset pipeline

Need to customize your build? Want automatically-generated spritesheets? Source maps? Sails.js uses Grunt for its asset pipeline, which means it supports any Grunt plugin. out of the box. There are thousands of Grunt plugins available on NPM.

Learn how to customize your app's asset pipeline.

Generators

Don't like Grunt? Want to use WebPack or Gulp instead? Prefer your generated backend files to be written in CoffeeScript? There are at least 100 community generators for Sails.js available on NPM.

Learn how to use community generators, and how to build your own.

Database adapters

Is your database not supported by one of the core adapters? Good news! There are many different community database adapters for Sails.js and Waterline available on NPM.

Learn how to install and configure community adapters.

Filesystem adapters

Need to upload files to a cloud file store like S3, GridFS, or Azure Cloud Files? Check out the community filesystem adapters for Sails.js and Skipper available on NPM.

Learn how to wire up one or more custom filesystem adapters for your application.

3rd party integrations

Need to process payments with Stripe? Fetch video metadata from YouTube? Process user email data via Google APIs? Choose from hundreds of community machinepacks for Sails.js/Node available on NPM.

Learn how to install and use machinepacks in your controller actions and helpers.

Database drivers

Want to work with your database at a low level? Need to get extra performance out of your database queries? Dynamic database connections?

Learn about Waterline drivers.

View engines

Is EJS bumming you out? Prefer to use a different templating language like pug (/jade), handlebars, or dust? Sails.js supports almost any Consolidate/Express-compatible view engine-- meaning you can use just about any imaginable markup language for your Sails.js views. Check out the community view engines for Sails.js and Express available on NPM.

Learn how to set up a custom view engine for your app.

Session stores

The recommended production session store for Sails.js is Redis... but we realize that, for some apps, that isn't an option. Fortunately, Sails.js supports almost any Connect/Express-compatible session store-- meaning you can store your sessions almost anywhere, whether that's Mongo, on the local filesystem, or even in a relational database. Check out the community session stores for Sails.js, Express, and Connect available on NPM.

Learn how to install and configure a custom session store in your Sails app.

Community socket client SDKs & examples

Need to connect to Sails from a native iPhone or Android app?

Platform Repo Build Status (edge)
iOS sails.ios CI Status
Objective C sails.io.objective-c N/A
Android Sails Messenger N/A
React Native React Native example N/A
Cordova Phonegap tips N/A

Misc. projects

Package Latest Stable Release Purpose
sails-migrations NPM version Manual migration tool for Sails, built on Knex.
sails-mysql-transactions NPM version Augmented database adapter for mySQL with transaction and replication support.
sails-inverse-model Generate Sails/Waterline model definitions from a pre-existing database.

FAQ

What happened to the core generators?

For easier maintainence, they were pulled into sails-generate.

What release of XYZ should I install?

You can read about naming conventions for plugins and core modules here. Covers NPM dist tags, git tags, and version strings, as well as recommendations for hotfix branches.