roosevelt
Advanced tools
Roosevelt is a web application development framework based on Express that aims to be the easiest web framework on the Node.js stack to learn and use.
Some notable features:
Note: this is documentation for the current version of Roosevelt. If you need API documentation for a previous version of Roosevelt, look here.
First you will need to install Node.js. Both the current and LTS version of Node.js are supported. It is recommended that you install using a Node.js version manager like nvm rather than the official installer, as a version manager will allow you to switch between multiple versions of Node.js easily.
Some important caveats to note:
The Java JDK is also required for development work. The JDK is required for the local HTML validator feature.
Once you have a sane development environment, you can proceed with the standard install procedure below.
The Roosevelt app generator is a command line script based on Yeoman that can create a sample Roosevelt app for you.
To use it, first globally install Yeoman and the Yeoman-based Roosevelt app generator:
npm i -g yo generator-roosevelt
Create a Roosevelt app using the Roosevelt app generator:
yo roosevelt
Then follow the prompts.
Afterward, cd to your app's directory and install dependencies:
npm i
Run in development mode:
npm run d
Or run in production mode:
npm run p
It is also possible to create a Roosevelt app without using the app generator. This will result in a more minimalist default configuration (e.g. no CSS or JS preprocessors enabled by default).
To do that:
First create a new folder and cd into it.
Then npm i roosevelt. This will create a node_modules folder with Roosevelt and its bare minimum dependencies.
Create a file named app.js.
Put this code in app.js:
require('roosevelt')({
'generateFolderStructure': true
}).startServer()
Then node app.js. If the generateFolderStructure parameter is set to true like the above code example, an entire Roosevelt app with bare minimum viability will be created and the server will be started. See below for more information about parameter configuration.
Roosevelt apps created with the app generator come with the following notable npm scripts prepopulated in package.json:
npm run dev-install: Installs Roosevelt with its devDependencies to support running Roosevelt in development mode.
npm run dicd ./node_modules/roosevelt && npm install --only=devnpm run dev-prune: Removes Roosevelt's devDependencies to support deploying Roosevelt apps with smaller production builds. Note: can prevent being able to run Roosevelt in development mode.
npm run dpcd ./node_modules/roosevelt && npm prune --productionnpm run production: Runs the app in production mode.
npm run prodnpm run pnpm startnodemon app.js --production-modenpm run development: Runs the app in development mode.
npm run devnpm run dnodemon app.js --development-modenpm run proddev: Runs the app in production mode, but with the public folder hosted by the Roosevelt app. This is useful for doing development in production mode without having to stage a complex simulation of your production environment, which would likely include hosting static files via another web server better-suited to serving statics like Apache or nginx.
npm run pdnodemon app.js --host-publicnpm run kill-validator: Finds the HTML validator process and kills it if it is running.
npm run kvnode ./node_modules/roosevelt/lib/scripts/killValidator.jsnpm run clean: Removes all build artifacts (symlinks and directories) auto-generated by Roosevelt. Will prompt to confirm before deleting any files.
npm run cnode ./node_modules/roosevelt/lib/scripts/appCleanup.jsnpm run config-audit: Scans current rooseveltConfig and scripts in package.json and warns about any parameters or npm scripts that don't match the current Roosevelt API:
npm run anode ./node_modules/roosevelt/lib/scripts/configAuditor.jsnpm i as well.node app.js --production-mode: Runs the app in production mode.
--prod-pnode app.js --development-mode: Runs the app in development mode.
--dev-dnode app.js --cores <m>: Configures how many CPUs your app will run on.
<m> can be either a number representing the desired cores, or you can supply max to use all available CPUs.
1.-cnode app.js --enable-validator: Forces the HTML validator to be enabled.
--html-validator-hnode app.js --disable-validator: Forces the HTML validator to be disabled.
--raw-rnode app.js --background-validator: Forces the HTML validator to run as a detached background process.
-bnode app.js --attach-validator: Forces the HTML validator to run as an attached process.
-anode app.js --enable-validator-autokiller: Forces the HTML validator autokiller to be enabled.
--html-validator-autokiller-knode app.js --disable-validator-autokiller: Forces the HTML validator autokiller to be disabled.
--no-autokiller-nnode app.js --host-public: Forces Roosevelt to always host the public folder even when alwaysHostPublic is set to false. Useful for testing production mode.
--statics-sThe npm scripts can be combined with the command line flags.
For example, running npm run d -- -r will run your app in development mode and force the HTML validator to be disabled.
The following is a list of environment variables that Roosevelt listens for.
NODE_ENV:
production to force the app into production mode.development to force the app into development mode.NODE_PORT: Default HTTP port to run your app on.HTTP_PORT: Default HTTP port to run your app on. Takes precedence over NODE_PORT.HTTPS_PORT: Default HTTPS port to run your app on.ROOSEVELT_VALIDATOR:
detached to force the HTML validator to run as a detached background process.attached to force the HTML validator to run as an attached process.ROOSEVELT_AUTOKILLER:
on to spawn a process to kill the HTML validator if it is running in the background and idle for more than a certain amount of time. The timeout can be configured in app behavior parameters.offto disable the HTML validator autokiller.Environment variable precedence:
app.js: Entry point to your application. Feel free to rename this, but make sure to update package.json's reference to it.mvc: Folder for models, views, and controllers. All configurable via parameters (see below).
controllers: Folder for controller files.models: Folder for model files.views: Folder for view files.node_modules: A standard folder where all modules your app depends on (such as Roosevelt) are installed to. This folder is created by the npm i command.package.json: A standard file in Node.js apps for configuring your app.public: All contents within this folder will be exposed as static files.statics: Folder for source CSS, image, JS, and other static files. By default some of the contents of this folder are symlinked to from public, which you can configure (see below).
css: Folder for source CSS files.images: Folder for source image files.js: Folder for source JS files..gitignore: A standard file which contains a list of files and folders to ignore if your project is in a git repo.The default .gitignore file contains many common important things to ignore, however you may need to tweak it to your liking before committing a fresh Roosevelt app to your git repo.
Some notable things ignored by default and why:
public: It's recommended that you don't create files in this folder manually, but instead use the statics parameter detailed below to expose folders in your statics directory via auto-generated symlinks.node_modules: This folder will be auto-generated when you run the npm i step to set up your app. Since some modules you might include later in your app can be platform-specific and are compiled for your OS during the install step, it's generally not recommended to commit the node_modules folder to git.Roosevelt is designed to have a minimal amount of boilerplate so you can spend less time focused on configuration and more time writing your app. All parameters are optional. As such, by default, all that's in app.js is this:
require('roosevelt')().startServer();
Roosevelt will determine your app's name by examining "name" in package.json. If none is provided, it will use Roosevelt Express instead.
There are multiple ways to pass a configuration to Roosevelt:
A rooseveltConfig.json file located in the root directory of your app.
Via package.json under "rooseveltConfig".
Programmatically via Roosevelt's constructor like so:
require('roosevelt')({
paramName: 'paramValue',
param2: 'value2',
etc: 'etc'
}).startServer();
package.json or rooseveltConfig.json such as event handlers (see below).In addition, all parameters support template literal style variables. For example:
{
"port": 4000,
"https": {
"port": "${port + 1}"
},
"css": {
"sourcePath": "css",
"output": ".build/${css.sourcePath}",
}
}
Resolves to:
{
"port": 4000,
"https": {
"port": 4001
},
"css": {
"sourcePath": "css",
"output": ".build/css",
}
}
port: The HTTP port your app will run on.
43711.mode: The mode your application will start in.
production.enableCLIFlags: Enables parsing of command line flags.
true.generateFolderStructure: When enabled Roosevelt will generate user specified directories (e.g. MVC parameters and statics parameters).
Default: [Boolean] false.
true in apps generated with generator-roosevelt.This parameter is useful in scenarios when you want to create a Roosevelt app entirely from nothing (without using generator-roosevelt). See create a Roosevelt app manually for an example.
appDir: Root directory of your application.
package.json is located.localhostOnly: Listen only to requests coming from localhost in production mode. This is useful in environments where it is expected that HTTP requests to your app will be proxied through a more traditional web server like Apache or nginx. This setting is ignored in development mode.
true.logging: Parameters to pass to roosevelt-logger. See roosevelt-logger parameters documentation for configuration options.
Default: [Object]
{
"methods": {
"http": true,
"info": true,
"warn": true,
"error": true,
"verbose": false
}
}
You can also declare a custom log types and classify them as logs, warnings, or errors:
Default logging parameter with custom log type called debug added to it: [Object]
{
"http": true,
"info": true,
"warn": true,
"verbose": false,
"debug": {
"enable": true,
"type": "error"
}
}
enable parameter: Enables or disables the custom log.
true.type parameter: Specifies what kind of log your custom log is:
info, warn, or error.minify: Enables HTML minification as well as the minification step in supporting CSS and JS compilers.
Default: [Boolean] true.
Note: Automatically disabled during development mode.
htmlValidator: Parameters to send to html-validator:
enable: [Boolean] Enables or disables the built-in HTML validator.
exceptions: Sending a custom request header can disable the validator on a per request basis. The name of this request header and model value can be customized with this parameter.
Default: [Object]
"exceptions": {
"requestHeader": "Partial",
"modelValue": "_disableValidator"
}
port: [Number] Port to spawn the validator process on.
separateProcess: [Object] How to run the validator:
enable: [Boolean] Run the validator as a detached background process.
autoKiller: [Boolean] Spawns a process to kill the validator if it is running in the background and idle for more than a certain amount of time.
autoKillerTimeout: [Number] Time (in milliseconds) that the validator auto-killer process waits before it kills the validator running in the background.
"GET /roosevelt-dev-mode-ping HTTP/1.1" 404 in your HTTP logs when autoKiller is enabled if you allow your app to idle in development mode. This is a normal behavior that the autokiller uses to determine if it should kill the validator process.showWarnings: [Boolean] When set to true, shows HTML validation warnings in addition to errors.
Default: [Object]
{
"enable": true,
"separateProcess": {
"enable": true,
"autoKiller": true,
"autoKillerTimeout": 360000
},
"port": 48888,
"exceptions": {
"requestHeader": "Partial",
"modelValue": "_disableValidator"
},
"showWarnings": true
}
formidable: Settings to pass along to formidable using formidable's API for multipart form processing. Access files uploaded in your controllers by examining the req.files object. Roosevelt will remove any files uploaded to the uploadDir when the request ends automatically. To keep any, be sure to move them before the request ends. To disable multipart forms entirely, set this parameter to false.
Default: [Boolean]
{
"multiples": true
}
toobusy: Parameters to pass to the node-toobusy module.
maxLagPerRequest: [Number] Maximum amount of time (in milliseconds) a given request is allowed to take before being interrupted with a 503 error.
lagCheckInterval: [Number] Interval (in milliseconds) for checking event loop lag in milliseconds.
Default: [Object]
{
"maxLagPerRequest": 70,
"lagCheckInterval": 500,
}
bodyParser: Parameters to supply to the body-parser module.
urlEncoded: [Object] Parameters to supply to body-parser.urlencoded.
json: [Object] Parameters to supply to body-parser.json.
Default: [Object]
{
"urlEncoded": {
"extended": true
},
"json": {}
}
checkDependencies: Whether or not to warn if dependencies are out of date.
true.cores: By default, Roosevelt will run on 1 CPU, but you can change the number of cores that the app will run on with this parameter.
Default: [Number] 1.
To use all available cores, set this value to max.
shutdownTimeout: Maximum amount of time in milliseconds given to Roosevelt to gracefully shut itself down when sent the kill signal.
30000 (30 seconds).https: [Object] Run a HTTPS server using Roosevelt.
Object members:
enable: Enable a HTTPS server.
false.force: Disallow unencrypted HTTP and route all traffic through HTTPS.
false.port: The port your app will run a HTTPS server on.
43733.authInfoPath: [Object] Specify either the paths where the server certificate files can be found or set the appropriate parameters to be a PKCS#12-formatted string or certificate or key strings.
Default: undefined.
Object members:
p12: [Object] Parameter used when the server certificate/key is in PKCS#12 format.
Object members:
p12Path: [String] Either the path to a PKCS#12-formatted file (.p12/.pfx) or a PKCS#12-formatted string or buffer (i.e. the result of fs.readFileSync(/path/to/file/example.p12))
undefined.passphrase: [String] The password used to encrypt the PKCS#12-formatted file or string.
undefined.authCertAndKey: [Object] Parameter used when the server certificate and key are in separate PEM-encoded files.
Object members:
cert: [String] Either the path to a PEM-encoded certificate file (.crt, .cer, etc.) or a PEM-encoded certificate string.
undefined.key: [String] Either the path to a PEM-encoded key file (.crt, .cer, etc.) or a PEM-encoded key string for the certificate given in cert.
undefined.caCert: [String] Either the path to a PEM-encoded Certificate Authority root certificate or certificate chain or a PEM-encoded Certificate Authority root certificate or certificate chain string. This certificate (chain) will be used to verify client certificates presented to the server. It is only needed if requestCert and rejectUnauthorized are both set to true and the client certificates are not signed by a Certificate Authority in the default publicly trusted list of CAs curated by Mozilla.
undefined.requestCert: [Boolean] Set whether to request a certificate from the client attempting to connect to the server to verify the client's identity.
undefined.rejectUnauthorized: [Boolean] Set whether to reject connections from clients that do no present a valid certificate to the server. (Ignored if requestCert is set to false.)
undefined.Default: [Object] {}.
modelsPath: Relative path on filesystem to where your model files are located.
"mvc/models".viewsPath: Relative path on filesystem to where your view files are located.
"mvc/views".viewEngine: What templating engine to use, formatted as "fileExtension: nodeModule".
generator-roosevelt default: [String] "html: teddy".
Also by default when using the generator, the module teddy is marked as a dependency in package.json.
Bare Roosevelt default (when an app is created without the generator): [String] none. Can also be set to null to use no templating engine.
To use multiple templating systems, supply an array of engines to use in the same string format. Each engine you use must also be marked as a dependency in your app's package.json. Whichever engine you supply first with this parameter will be considered the default.
Example configuration using multiple templating systems: [Object]
{
"viewEngine": [
"html: teddy",
"mustache: mustache",
"handlebars: handlebars",
"ejs: ejs"
]
}
controllersPath: Relative path on filesystem to where your controller files are located.
"mvc/controllers".errorPages: Relative path on filesystem to where your various error page controller files are located. If you do not supply them, Roosevelt will use its default ones instead:
notFound: Your 404 Not Found error page.
"404.js".internalServerError: Your Internal Server Error error page.
"5xx.js".serviceUnavailable: Your 503 Service Unavailable error page.
"503.js".routePrefix: [String] A subdirectory to mount your application to. Applies to all routes and static files.
Example: When set to "foo" a route bound to / will be instead be bound to /foo/.
Note: This prefix is exposed via the routePrefix Express variable which should be used for resolving the absolute paths to statics programmatically.
/images/teddy.jpg can be resolved in a prefix agnostic way via `${app.get('routePrefix')/images/teddy.jpg}`.Default: null.
staticsRoot: Relative path on filesystem to where your source static assets are located. By default this folder will not be made public, but is instead meant to store unprocessed or uncompressed source assets that will later be preprocessed and exposed in public.
"statics".htmlMinifier: How you want Roosevelt to minify your HTML:
enable: [Boolean] Enable HTML minification.
Note: Minification is automatically disabled in development mode.
exceptionRoutes: [Array] List of controller routes that will skip minification entirely. Set to false to minify all URLs.
options: [Object] Parameters to supply to html-minifier's API.
Default: [Object]
{
"enable": true,
"exceptionRoutes": false,
"options": {
"removeComments": true,
"collapseWhitespace": true,
"collapseBooleanAttributes": true,
"removeAttributeQuotes": true,
"removeEmptyAttributes": true
}
}
css: [Object] How you want Roosevelt to configure your CSS preprocessor:
sourcePath: Subdirectory within staticsRoot where your CSS files are located. By default this folder will not be made public, but is instead meant to store unminified CSS source files which will be minified and written to a build directory when the app is started.
compiler: [Object] Which CSS preprocessor (if any) to use.
enable: [Boolean] Whether or not to use a preprocessor.
module: [String] Node module name of the CSS preprocessor you wish to use.
options: [Object] Parameters to send to the CSS preprocessor if it accepts any.
minifier: [Object] Params pertaining to CSS minifcation.
enable: [Boolean] Whether or not to minify css.
minify param, which is disabled in development mode.options: [Object] Parameters to pass to the CSS minifier clean-css, a list of which can be found in the clean-css docs.
whitelist: Array of CSS files to whitelist for compiling. Leave undefined to compile all files. Supply a : character after each file name to delimit an alternate file path and/or file name for the minified file.
less/example.less:.build/css/example.min.css (compiles less/example.less into .build/css/example.min.css).output: Subdirectory within publicFolder where compiled CSS files will be written to.
versionFile: If enabled, Roosevelt will create a CSS file which declares a CSS variable containing your app's version number from package.json. Enable this option by supplying an object with the member variables fileName and varName.
Default: null.
Example usage (with roosevelt-less): [Object]
{
"fileName": "_version.less",
"varName": "appVersion"
}
Assuming the default Roosevelt configuration otherwise, this will result in a file statics/css/_version.less with the following content:
/* do not edit; generated automatically by Roosevelt */ @appVersion: '0.1.0';
Some things to note:
If there is already a file there with that name, this will overwrite it, so be careful!
It's generally a good idea to add this file to .gitignore, since it is a build artifact.
Default: [Object]
{
"sourcePath": "css",
"compiler": {
"enable" : false,
"module": "less",
"options": {}
},
"minifier": {
"enable": true,
"options": {}
},
"whitelist": null,
"output": "css",
"versionFile": null
}
js: [Object] How you want Roosevelt to configure your JS compiled:
sourcePath: Subdirectory within staticsRoot where your JS files are located. By default this folder will not be made public, but is instead meant to store unminified JS source files which will be minified and written to a build directory when the app is started.
webpack: Parameters related to bundling JS with Webpack:
enable: Enable Webpack bundling.
bundles: [Array] Declare one or more Webpack configurations to bundle JS with.
env: [String] Bundle only in dev or prod mode. Omitting env will result in bundling in both modes.
config: [Object] or [String] The Webpack configuration to send to Webpack. Can also be a path to a Webpack config file relative to the app directory.
Examples: [Array] of [Objects]
Webpack bundle example declaring one bundle:
[
{
"config": {
"entry": "${js.sourcePath}/main.js",
"output": {
"path": "${publicFolder}/js",
"filename": "bundle.js"
}
}
}
]
Webpack bundle example declaring one bundle only used in dev mode:
[
{
"env": "dev",
"config": {
"entry": "${js.sourcePath}/main.js",
"output": {
"path": "${publicFolder}/js",
"filename": "bundle.js"
}
}
}
]
Webpack bundle example declaring multiple bundles:
[
{
"config": {
"entry": "${js.sourcePath}/main.js",
"output": {
"path": "${publicFolder}/js",
"filename": "bundle.js"
}
}
},
{
"config": {
"entry": "${js.sourcePath}/moreStuff.js",
"output": {
"path": "${publicFolder}/js",
"filename": "bundle2.js"
}
}
},
etc...
]
Default: [Array] [].
Default: [Object]
{
"sourcePath": "js",
"webpack": {
"enable": false,
"bundles": [],
}
}
frontendReload: Settings to use for the reload module which automatically reloads your browser when your frontend code changes.
Default: [Object]
{
"enable": true,
"port": 9856,
"httpsPort": 9857,
"verbose": false
}
clientViews: [Object] Allows you to expose view code to frontend JS for client-side templating.
exposeAll: [Boolean] Option to expose all templates. This will exclude templates that have <!-- roosevelt-blacklist --> at the top of the file or those listed in the blacklist property of clientViews.
false.blacklist: [Array] of [Strings] List of files or folders excluded when exposeAll is on.
Default: [Array] of [Strings] [].
Note: Anything that is in the blacklist or that has a <!-- roosevelt-blacklist --> tag will never be added to any whitelist.
whitelist: [Object] List of JS files to create mapped to which view files to expose.
Default: [Object] of [Arrays] {}.
Example:
{
"mainLayouts.js": ["baseLayout.html", "footer.html"],
"forms.js": ["forms/formTemplate.html"]
}
defaultBundle: [String] File name for the default location of templates if not specified with the <!-- roosevelt-whitelist <filepath> --> tag at the top of any template.
"bundle.js".output: [String] Subdirectory within publicFolder to define where to save the view JS bundles.
Default: [String] "templates".
minify: [Boolean] Option to minify templates that are exposed via this feature.
Default: [Boolean] true.
minifyOptions: [Object] Parameters to supply to html-minifier's API.
Uses the params you set in htmlMinifier.options if empty.
Default: [Object]
"clientViews": {
"exposeAll": false,
"blacklist": [],
"whitelist": {},
"defaultBundle": "bundle.js",
"output": "templates",
"minify": true,
"minifyOptions": {}
}
publicFolder: All files and folders in this directory will be exposed as static files in development mode or when alwaysHostPublic is enabled.
"public".favicon: Location of your favicon file.
generator-roosevelt default: [String] "images/favicon.ico".
Bare Roosevelt default (when an app is created without the generator): [String] none. Can also be set to null to use no favicon.
symlinks: [Array] Declare one or more symlinks to be generated at run time.
source: [String] Path to be linked to.
dest: [String] Path to place symlink
Default: [Array] of [Objects]
[
{
"source": "${staticsRoot}/images",
"dest": "${publicFolder}/images"
}
]
versionedPublic: If set to true, Roosevelt will prepend your app's version number from package.json to your public folder. Versioning your public folder is useful for resetting your users' browser cache when you release a new version.
false.alwaysHostPublic: By default in production mode Roosevelt will not expose the public folder. It's recommended instead that you host the public folder yourself directly through another web server, such as Apache or nginx. However, if you wish to override this behavior and have Roosevelt host your public folder even in production mode, then set this setting to true.
false.Roosevelt provides a series of events you can attach code to by passing a function to the desired event as a parameter to Roosevelt's constructor like so:
require('roosevelt')({
onServerStart: (app) => { /* do something */ }
});
onServerInit(app): Fired when the server begins starting, prior to any actions taken by Roosevelt. Note: the multipart, routes, and roosevelt:state Express variables exposed by Roosevelt are not available yet during this event.
app: The Express app created by Roosevelt.onServerStart(app): Fired when the server starts.
app: The Express app created by Roosevelt.onReqStart(req, res, next): Fired at the beginning of each new request.
req: The request object created by Express.res: The response object created by Express.next: Callback to continue with the request. Must be called to continue the request.onReqBeforeRoute(req, res, next): Fired just before executing the controller.
req: The request object created by Express.res: The response object created by Express.next: Callback to continue with the request. Must be called to continue the request.onReqAfterRoute(req, res): Fired after the request ends.
req: The request object created by Express.res: The response object created by Express.onClientViewsProcess(template): Fired to preprocess templates before being exposed to the client
template: A string containing a template written in any templating engine (Teddy, Pug, Handlebars, etc)Controller files are places to write Express routes. A route is the term Express uses for URL endpoints, such as http://yoursite/blog or http://yoursite/about.
To make a new controller, make a new file in the controllers directory. For example:
module.exports = (router, app) => { // router is an Express router and app is the Express app created by Roosevelt
// standard Express route
router.route('/about').get((req, res) => {
// load a data model
let model = require('models/dataModel');
// render a Teddy template and pass it the model
res.render('about', model);
});
};
Sometimes it is also useful to separate controller logic from your routing. This can be done by creating a reusable controller module.
An example would be creating a reusable controller for "404 Not Found" pages:
// reusable controller "notFound.js"
module.exports = (app, req, res) => {
let model = { content: 'Cannot find this page' };
res.status(404);
res.render('404', model);
}
Reusable controller modules differ from standard controller modules in that they accept req and res arguments in addition to app. They are meant to be called from within routes rather than define new routes.
This allows them to be called at will in any other controller's route when needed:
// import the "notFound" controller logic previously defined
const throw404 = require('controllers/notFound');
module.exports = (router, app) => {
router.route('/whatever').get((req, res) => {
// test some logic that could fail
// thus triggering the need for the 404 controller
if (something) {
// logic didn't fail
// so render the page normally
let model = require('models/dataModel');
res.render('whatever', model);
}
else {
// logic failed
// so throw the 404 by executing your reusable controller
throw404(app, req, res);
}
});
};
Since the above example requires a model file named dataModel, you will need to make that too. To do that, place a file named dataModel.js in mvc/models.
Here's a simple example dataModel.js data model:
module.exports = {some: 'data'};
Views by default are Teddy templates. See the Teddy documentation for information about how to author Teddy templates.
You can also use different templating engines by tweaking Roosevelt's MVC parameters.
Roosevelt supplies several variables to Express that you may find handy. Access them using app.get('variableName').
| Express variable | Description |
|---|---|
express | The Express module. |
router | Instance of router module used by Roosevelt. |
routePrefix | Prefix appended to routes via the routePrefix param. Will be '' if not set. |
routes | List of all routes loaded in the Express app by Roosevelt. |
viewEngine e.g. teddy by default | Any view engine(s) you define will be exposed as an Express variable. For instance, the default view engine is teddy. So by default app.get('teddy') will return the teddy module. |
view engine | Default view engine file extension, e.g. .html. |
formidable | The formidable module Roosevelt uses internally. Used for handling multipart forms. |
morgan | The morgan module Roosevelt uses internally. HTTP request logger middleware. |
logger | The roosevelt-logger module Roosevelt uses internally. Used for console logging. |
modelsPath | Full path on the file system to where your app's models folder is located. |
viewsPath or views | Full path on the file system to where your app's views folder is located. |
controllersPath | Full path on the file system to where your app's controllers folder is located. |
clientViewsBundledOutput | Full path on the file system to where your app's client exposed views folder is located |
staticsRoot | Full path on the file system to where your app's statics folder is located. |
publicFolder | Full path on the file system to where your app's public folder is located. |
cssPath | Full path on the file system to where your app's CSS source files are located. |
jsPath | Full path on the file system to where your app's JS source files are located. |
cssCompiledOutput | Full path on the file system to where your app's minified CSS files are located. |
env | Either development or production. |
params | The parameters you sent to Roosevelt. |
appDir | The directory the main module is in. |
appName | The name of your app derived from package.json. Uses "Roosevelt Express" if no name is supplied. |
appVersion | The version number of your app derived from package.json. |
package | The contents of package.json. |
roosevelt:state | Application state, e.g. disconnecting if the app is currently being shut down. |
Additionally the Roosevelt constructor returns the following object:
| Roosevelt object members | Description |
|---|---|
expressApp | [Object] The Express app created by Roosevelt. |
httpServer | [Object] The http server created by Roosevelt. httpServer is also available as a direct child of app, e.g. app.httpServer. |
httpsServer | [Object] The https server created by Roosevelt. httpsServer is also available as a direct child of app, e.g. app.httpsServer. |
initServer | [Method] Starts the HTML validator, sets up some middleware, runs the CSS and JS preprocessors, and maps routes, but does not start the HTTP server. Call this method manually first instead of startServer if you need to setup the Express app, but still need to do additional setup before the HTTP server is started. This method is automatically called by startServer once per instance if it has not yet already been called. Takes an optional callback. |
startServer | [Method] Calls the listen method of http, https, or both (depending on your configuration) to start the web server with Roosevelt's config. |
stopServer | [Method] Stops the server and takes an optional argument stopServer('close') which stops the server from accepting new connections before exiting. |
In addition to exposing a number of variables to Express and providing the MVC interface outlined above, Roosevelt also:
x-powered-by and etag.morgan('combined').In contexts where you only need to run Roosevelt in production mode, you can remove some dependencies that are only needed in development mode in order to shrink the footprint of production builds.
The biggest development mode-only dependency you can remove is vnu-jar. To remove it, run npm rm vnu-jar --no-save.
The complete list of Roosevelt dependencies that are only needed in development mode is:
execafkillhtml-validatorpid-from-portprismjsps-nodereloadtampervnu-jarTo remove them all, run npm rm execa fkill html-validator pid-from-port prismjs ps-node reload tamper vnu-jar --no-save.
Be sure none of those dependencies are needed elsewhere in your app first.
In addition to Roosevelt's built-in support for the LESS, Sass, and Stylus preprocessors you can also define your own preprocessors on the fly at start time in Roosevelt's constructor like so:
let app = require('roosevelt')({
cssCompiler: app => {
return {
versionCode: app => {
// write code to return the version of your app here
},
parse: (app, filePath) => {
// write code to preprocess CSS here
}
}
}
})
API:
cssCompiler(app): Custom CSS preprocessor.
versionCode(app): Function to return the version of your app.
app: The Express app created by Roosevelt.parse(app, fileName): Function to preprocess CSS.
app: The Express app created by Roosevelt.filePath: The path to the file being compiled.Note: When a custom preprocessor is defined in this way it will override the selected preprocessor specified in css.compiler.module.
0.17.1
FAQs
Roosevelt MVC web framework
The npm package roosevelt receives a total of 169 weekly downloads. As such, roosevelt popularity was classified as not popular.
We found that roosevelt demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Malicious PyPI package ‘set-utils’ steals Ethereum private keys by exfiltrating them through blockchain transactions via the Polygon RPC.
Research
Security News
Malicious Go packages are impersonating popular libraries to install hidden loader malware on Linux and macOS, targeting developers with obfuscated payloads.
Security News
Bybit's $1.46B hack by North Korea's Lazarus Group pushes 2025 crypto losses to $1.6B in just two months, already surpassing all of 2024's $1.49B total.