Go to file
William Riley-Land b07706d1f2 2.0.8 2023-01-18 10:41:38 -06:00
Api Add TODO for better OPTIONS handling. 2015-07-03 12:22:07 -05:00
Controller 2.0.7 2022-12-14 14:51:16 -06:00
examples v0.11.0 Add API versioning using the `API-Version` header. 2013-12-28 22:53:53 -06:00
test Fix test that was too strict. 2020-07-31 21:34:10 -05:00
.gitignore Fixing all package vulnerabilities 2020-08-01 13:52:37 -03:00
CHANGES.md Add thank you. 2020-03-06 12:12:06 -06:00
LICENSE.md Intermediate refactoring 2013-12-29 17:16:21 -06:00
Model.js Always using lower case paths, regardless of the model name 2020-07-30 16:39:03 -03:00
PATENTS.md v1.0.0-prerelease.5 Add PATENTS file and more cleaning up. 2014-04-30 21:55:15 -05:00
README.md Update README.md 2021-06-17 12:41:47 -05:00
appnow-logo.png v1.0.0-candidate.11 Read me tweaks, add affiliate section. 2014-09-23 09:54:05 -05:00
david_rijckaert_iii-philemon_and_baucis.jpg Adds image and TODOs for README 2012-07-12 11:52:27 -05:00
hivepod-io-logo.png Add Hivepod.io logo. 2015-10-09 10:05:38 -05:00
index.js Don't run formatter if headers were sent already. 2016-03-01 13:27:51 -06:00
kunio.png v1.0.5 Updates to the README. 2015-03-06 16:16:42 -06:00
package-lock.json 2.0.8 2023-01-18 10:41:38 -06:00
package.json 2.0.8 2023-01-18 10:41:38 -06:00
pixel-press.jpg v1.0.5 Updates to the README. 2015-03-06 16:16:42 -06:00




Build scalable REST APIs using the open source tools and standards you and your team already know — Mongoose, Express, and Node.js streams. Baucis takes the boilerplate out of building and maintaining scalable HATEOAS/Level 3 REST APIs.

Baucis is used in production by startups, departments, and Fortune 500 companies, and at hackathons and conferences worldwide. MongoDB, Inc. awarded baucis first place in their 2014 Open Source Hack Contest.

Baucis is easy for beginners, easy to scale, yet flexible enough in the long term to be extended to solve complex use cases.

Hivepod.io Kun.io App Studio LLC Pixel Press

If you like baucis please consider adding bounties to issues in the issue tracker or contributing via GitTip.


  • Automatically build controllers from your Mongoose schemata, then easily configure them.
  • Built on Express 4 so adding custom middleware is a snap. Compatible with existing Express middleware.
  • Fully takes advantage of Node.js streaming to nimbly process large datasets.
  • Implements the HTTP specification according to the specifications (RFC 7231, etc.)
  • Widely compatible with a variety of front end frameworks.
  • Perform rich queries of the API using an expressive JSON syntax via query string.
  • Supports geolocation and full text search.
  • Version your API using semver.
  • Automatically generate interactive Swagger documentation for the API.
  • Highly customizable, simple interface. Can be extended with plugins (decorators).
  • Compatible with MongoDB 2.x and 3.x
  • Over 140 Mocha.js tests in addition to Express' and Mongoose's.

Getting Started

To install:

npm install --save baucis

It's easy to create an API from a Mongoose model:

// Create a mongoose schema.
var Vegetable = new mongoose.Schema({ name: String });
// Register new models with mongoose.
mongoose.model('vegetable', Vegetable);
// Create a simple controller.  By default these HTTP methods
// are activated: HEAD, GET, POST, PUT, DELETE
// Create the app and listen for API requests
var app = express();
app.use('/api', baucis());

That's it! Now you have an RFC-compliant, flexible, and semantically rich API dealing with vegetables. You could access it with URLs like http://localhost:8012/api/vegetables. CRUD is supported using GET, PUT, POST, and DELETE.



Check out the Wiki for documentation and more in-depth information about baucis. Check the change log for info on recently implemented features.


© 2012-2021 Kun.io App Studio LLC