ForgeDocumentation
en

Documentation

Why choose Total.js for a Node.js application

Total.js 5 · total5@0.0.19 frameworknodejschoosealternativesarchitecture Executed against Total.js 5

Total.js 5 is a complete Node.js application framework, distributed as total5. One package gives a team HTTP routes, input validation, server-rendered views, authentication, uploads, WebSocket routes, scheduled jobs, localization, email and more, all designed to work together. You build the application instead of choosing, wiring and maintaining a dozen separate libraries.

What your project gets

What your project needsWhat Total.js gives youSee it in Forge
An internal business application with forms, protected routes and file uploadsNative input schemas, authentication hooks and upload handling, ready to useValidation, authentication, uploads
A dashboard with live updates and periodic reportsWebSocket routes, scheduled jobs and email in the same frameworkWebSocket example, cron jobs, email
A small team that wants to ship and maintain one server applicationAuto-loaded files and a shared set of conventions that keep every project familiarProject structure, conventions
A server-rendered applicationViews, layouts and localization inside the same frameworkViews and layouts, localization

Every row links to an example that Forge executes. On the frontend, Total.js has jComponent and a catalogue of hundreds of ready components, so the same ecosystem covers the interface too; using them is optional.

Why teams choose Total.js

A core without external dependencies. The installed total5 package declares no third-party runtime dependencies. There is no chain of modules written by different authors to keep compatible, no abandoned package that stops your build, no surprise from a transitive update. Continuity like this has a direct and powerful effect on how well a project scales and how easily it is maintained over the years: what you learn and ship today keeps working, backed by one project.

Built-in security APIs. The framework includes authentication, signed sessions, CSRF checks, scrypt password hashing and action input validation. Apply these facilities to your application routes and data. The Taskboard reference application combines them in one application.

A fast learning curve. Total.js is JavaScript, with conventions that are quick to pick up, so a team that does not know it yet is not at a disadvantage. The Total.js repositories hold a large collection of scripts, examples and complete applications under the MIT licence that you can read, reuse and learn from, and Forge adds executed recipes for the rest.

Fast and light. Total.js is fast, and one package with no dependency tree keeps it light: fewer things to load, update and audit, which counts most on small servers and small devices. Forge measures it under controlled conditions and publishes latency, CPU and memory for every workload, with the raw data, in the benchmarks.

Start simple: a direct HTTP route

This executable example validates a body with a compact native schema and answers directly from a controller: a few lines and no extra layers. As the application grows, domain actions add a reusable, validated contract that you can call from routes, code and tools.

controllers/contacts.js
var schema = NEWSCHEMA('ContactsInput', '*name:String');

exports.install = function() {
	ROUTE('GET /health/', health);
	ROUTE('POST /contacts/', create);
};

function health($) {
	$.json({ ok: true });
}

function create($) {
	var result = schema.transform($.body);
	if (result.error) {
		$.response.status = 400;
		$.json({ error: 'invalid' });
		return;
	}
	$.response.status = 201;
	$.json({ name: result.response.name });
}

Sources

Forge pairs its claims with things you can run. The Total.js guidelines describe the ecosystem's coding style, Total.js AI Context supplies implementation guidance and the source manifest records the reviewed revisions. If a guide and the installed framework ever differ, the installed source is the reference.