Sails — MVC Framework for Node.js with Auto-Generated REST APIs

Introduction

Sails is a Node.js MVC framework designed to make it easy to build custom, enterprise-grade APIs and web applications. Inspired by Ruby on Rails, it provides convention-over-configuration patterns, an ORM (Waterline) that works with multiple databases, and automatic REST endpoint generation from data models.

What Sails Does

• Auto-generates RESTful CRUD endpoints (blueprint APIs) from model definitions
• Provides Waterline ORM supporting MySQL, PostgreSQL, MongoDB, and Redis simultaneously
• Includes built-in WebSocket integration via Socket.IO for real-time events
• Supports policies (middleware) for authentication and access control per route
• Generates project scaffolding with a CLI that follows Rails-like conventions

Architecture Overview

Sails runs on top of Express.js and layers its own routing, middleware pipeline, and ORM. Incoming HTTP and WebSocket requests pass through configurable middleware, policies, and then controller actions. Waterline abstracts database access behind adapters, allowing a single app to query multiple datastores. Blueprint routes automatically expose CRUD operations, which can be overridden or disabled per model.

Self-Hosting & Configuration

• Install globally with npm install -g sails or use npx
• Configure datastores in config/datastores.js with connection strings for each adapter
• Define models in api/models/ with attribute schemas and validations
• Set environment-specific overrides in config/env/production.js
• Deploy as a standard Node.js app behind Nginx or any reverse proxy

Key Features

• Blueprint API auto-generation eliminates boilerplate CRUD code
• Multi-database support through Waterline adapters in the same application
• Real-time event broadcasting via integrated Socket.IO transport
• Granular policy system for route-level authorization and middleware
• Pluggable hook architecture for extending framework internals

Comparison with Similar Tools

• Express — Minimal and unopinionated; Sails adds MVC structure, ORM, and blueprints on top of Express
• NestJS — TypeScript-first with decorators and dependency injection, steeper learning curve, more enterprise patterns
• Fastify — Focused on raw HTTP performance and schema validation, no built-in ORM or MVC conventions
• Feathers — Lightweight service-oriented framework with real-time support, less opinionated project structure
• Adonis — Full-featured Node.js MVC framework with its own ORM (Lucid), closer to Laravel than Rails

FAQ

Q: Is Sails suitable for production APIs? A: Yes. Sails has been used in production by companies for REST and real-time APIs. Performance tuning involves disabling unused hooks and blueprint routes.

Q: Can I use Sails without the Waterline ORM? A: Yes. You can disable Waterline and use any database client or ORM like Sequelize, Knex, or Prisma directly in your controllers and services.

Q: Does Sails support TypeScript? A: Sails projects can be configured for TypeScript, though the framework itself is written in JavaScript. Community guides and boilerplates exist for TS setups.

Q: How does Sails handle WebSockets? A: Sails wraps Socket.IO and maps socket messages to the same routes as HTTP requests, so controller actions handle both transports transparently.

Sources

• https://github.com/balderdashy/sails
• https://sailsjs.com/documentation