Modelence

Website | Documentation | API Reference | Modelence Cloud

See what you can build in just a few hours with Modelence's batteries-included approach:

FinChat AI-powered financial chat assistant

SmartRepos Intelligent repository management

TypeSonic Compete on typing speed

Modelence is an all-in-one TypeScript framework for startups shipping production apps, with the mission to eliminate all boilerplate for standard features that modern web applications need, like authentication, database setup, cron jobs, AI observability, email and more.

Prerequisites: Modelence requires Node.js 20.20 or higher.

npx create-modelence-app@latest my-app

cd my-app
npm install

npm run dev

Your app will be available at http://localhost:3000

For a more detailed guide, check out the Todo App tutorial.

If you want to contribute to Modelence itself (not just use it in an application), follow the steps below.

git clone https://github.com/modelence/modelence.git
cd modelence

cd packages/modelence
npm install

npm run build

This generates the dist/ directory required for local usage.

npm run dev

This runs the build in watch mode and rebuilds on file changes.

Note

If you encounter dependency or build errors while developing Modelence locally, a clean install may help:

rm -rf node_modules package-lock.json
npm install
npm run build

This resets the local dependency state and mirrors the workflow often recommended when resolving local development issues. The regenerated package-lock.json is only for local development and should not be committed as part of a PR unless explicitly requested.

To test your local Modelence changes inside a real application:

npx create-modelence-app@latest my-app
cd my-app

Update package.json to point to your local Modelence package:

{
  "dependencies": {
    "modelence": "../modelence/packages/modelence"
  }
}

Then reinstall dependencies and start the app:

npm install
npm run dev

Your application will now use your local Modelence build.

For more examples on how to use Modelence, check out https://github.com/modelence/examples