A simplified backend system for Marcelle applications.
This is a wrapper around Feathers that provides a simplified interface for the creation of Marcelle data backends.
It currently supports NeDB and MongoDB databases.
The easiest way to get started is to use Marcelle's CLI. In an existing Marcelle application, run the cli with npx marcelle
. Select 'Manage the backend', then 'Configure a backend'. this will install @marcellejs/backend
as a dependency to your project and create configuration files.
Two database systems are currently available for storing data:
- NeDb - an embedded datastore with a MongoDB like API. NeDB can store data in-memory or on the filesystem which makes it useful as a persistent storage without a separate database server.
- MongoDb
The CLI will install @marcellejs/backend
and store configuration files in backend/config
.
To run the backend locally:
npm run backend
The backend API will be available on http://localhost:3030. From a Marcelle application, interacting with this backend can be done through data stores, by instanciating them with the server URL as location
parameter:
const store = dataStore('http://localhost:3030');
The backend can be configured using the file backend/config/default.json
.
The main options are:
-
database
:nedb
ormongodb
. For MongoDB, you will have to run mongod locally. -
authentication.enabled
: specifies if the backend should use authentication