CLI tool
modelence/modelence avatar
modelence/modelence

Modelence: an opinionated TypeScript full-stack framework aimed at AI code generation

Modelence is a full-stack framework for building production web apps with a built-in database, authentication and monitoring. Modelence is opinionated and AI agent-first, which means it's optimized for AI code generation with built-in guardrails.

431 stars49 forksTypeScriptNOASSERTION

At a glance

What is it?
Modelence bundles a database, authentication, scheduled jobs and monitoring into one TypeScript framework, and the README positions it as AI agent-first with built-in guardrails. The interesting question is not what it includes but what it takes away, and whether the hosted App Builder is the intended path in.
Who is it for?
Adopt Modelence if you want a single TypeScript package that already contains auth, a MongoDB-backed data layer, scheduled jobs and monitoring, and you are willing to accept the framework's opinions in exchange for not assembling those pieces yourself. Do not adopt it if you need a documented alternative to the hosted App Builder, or if you require a clear open source licence statement, because the repository is marked NOASSERTION and the README does not resolve it.
Can I use it commercially?
Check first. The repository uses a licence we do not classify automatically, so read its LICENSE file before any commercial use.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly TypeScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 16, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

What Modelence bundles, and who the bundle is for

Modelence describes itself as a full-stack framework for building and running production web applications, with authentication, database setup, scheduled jobs and monitoring included. That list is the product. A team starting a new TypeScript web app normally picks an auth library, a database and an ORM or driver, a job runner, and an error or performance monitoring service, then writes the glue between them. Modelence's pitch is that the glue is already written and the pieces share one configuration surface.

The stated audience is narrower than "full-stack developers". The README says Modelence is opinionated and AI agent-first, optimized for AI code generation with built-in guardrails. That is a design constraint, not marketing garnish. A framework built for generated code benefits from a small number of blessed ways to do a thing, because a generator that has three valid patterns to choose from will pick inconsistently across files. The cost lands on humans who want to structure an app differently.

The project is written in TypeScript, tagged with node, react and mongodb among its topics, and the release feed shows a steady cadence: 0.24.1 on 2026-09-08, a release candidate 0.25.0-rc.1 on 2026-09-09, and 0.25.0 the same day. Pre-1.0 versioning with release candidates in the open is worth noting if you are planning a long-lived codebase on it.

The App Builder is the documented front door, and that shapes everything else

The getting started path in the README does not involve installing anything. You go to cloud.modelence.com, describe the app you want, and submit the prompt. The README states that the App Builder will generate and deploy your app, and that this requires no setup, no CLI and no configuration.

Read that against the rest of the document. The only local instructions in the README are explicitly framed for people contributing to Modelence itself, not for people building applications with it. The section is headed Local Development (Modelence Framework) and opens by saying that if you want to contribute to Modelence itself, not just use it in an application, you should follow those steps. The application-level path that does not go through the hosted builder is a single line: npx create-modelence-app@latest my-app.

That is a real gap. If you want to evaluate Modelence without a cloud account, the README gives you one command and then moves on to how to point that scaffolded app at a local build of the framework. The documentation site is linked (docs.modelence.com, with a quickstart and an API reference), so the material exists elsewhere, but a reader deciding from the repository alone has to follow that link to learn how routing, data models or auth configuration actually look in code.

Building the framework locally: the commands the README actually gives

The contributor workflow is spelled out and is ordinary Node tooling. Clone the repository, change into the core package, install, build:

git clone https://github.com/modelence/modelence.git cd modelence cd packages/modelence npm install npm run build

The README states that the build generates the dist/ directory required for local usage. An optional watch mode is available through npm run dev, which the README says runs the build in watch mode and rebuilds on file changes.

There is a documented recovery step for dependency or build errors: remove node_modules and package-lock.json, then npm install and npm run build again. The README adds a constraint that matters for anyone opening a pull request: the regenerated package-lock.json is for local development only and should not be committed unless explicitly requested. It also points to CONTRIBUTING.md and states a policy on scope, that bug fixes and small improvements are welcome as pull requests while changes to the core runtime or public API surface should start with an issue.

To exercise a local build inside a real app, the README gives this sequence: run npx create-modelence-app@latest my-app, cd my-app, then edit package.json so the modelence dependency points at the local path, in the README's example "modelence": "../modelence/packages/modelence". Then npm install and npm run dev. The README states the application will then use your local Modelence build. Note the layout implied here: the repository is a monorepo with the core under packages/modelence, and the scaffolded app lives outside it.

What the repository does not tell you

The licence field on the repository is NOASSERTION. That is not a licence, it is the absence of a machine-readable one, and the README does not name a licence either. For a framework you would embed in a production application, that is the first thing to resolve, because the terms under which you may use, modify and redistribute the code determine whether it is usable at all in your context. Nothing in the supplied material tells you what those terms are, and this is not a question to settle by inference from the project's other choices.

Several other things are claimed but not shown. The description lists a built-in database, authentication and monitoring, and the topics include mongodb, but the README never shows a schema definition, an auth configuration, a job declaration or a monitoring setup. The phrase built-in guardrails for AI code generation is not expanded anywhere in the README; what those guardrails check, and whether they run at build time or in an editor, is not stated. Scheduled jobs appear in the feature list with no example of how a job is registered.

The example projects link points to cloud.modelence.com/showcase, and a separate examples repository is linked at github.com/modelence/examples. Both are external to this README, so a reader working only from the repository has no in-tree sample to read. For a framework whose main claim is that it reduces assembly work, the absence of a code sample in the README is a notable omission.

Where the opinionated design becomes the wrong tool

The clearest failure mode is architectural mismatch, and it follows directly from the framework's stated design. If your application already has an authentication system tied to a corporate identity provider, or a database that is not the one Modelence provisions, the built-in pieces are not a shortcut, they are something to work around or disable. The README does not describe an escape hatch for either case. A framework that ships auth and a database as built-ins is most valuable at the start of a project and least valuable when those decisions were made years ago.

The second issue is the deployment assumption. The primary documented path deploys through Modelence Cloud. The README does not describe self-hosting the runtime, containerizing it, or running it on another platform. That does not mean it is impossible; it means the repository does not say, and a team with an existing deployment pipeline should treat this as unverified until they read the documentation site.

The third is version maturity. Modelence is pre-1.0, with 0.25.0 published on 2026-09-09 and a release candidate the same day. Pre-1.0 projects can change public API between minor versions. The README's own contribution policy singles out the core runtime and public API surface as needing an issue first, which is a reasonable sign that the maintainers think about API stability, but it is not a compatibility promise. Pin your version and read release notes before upgrading.

How this differs from assembling the stack yourself

The obvious alternative is not a single competing framework but the conventional assembly: a Node or TypeScript server, a React front end, MongoDB with the official driver or an ODM such as Mongoose, an auth library, and a separate monitoring service. The difference in approach is where the decisions live. With the assembled stack, each concern has its own configuration file, its own environment variables and its own upgrade cycle, and you own the integration code between them. With Modelence, the README states that database setup, authentication, scheduled jobs and monitoring are built in, which means one dependency and one configuration surface, at the price of accepting the framework's choices for all four.

That trade is worth naming precisely. Assembly gives you substitution: swap the ODM, swap the auth provider, swap the monitoring vendor, each independently. Modelence gives you fewer moving parts and a smaller set of patterns, which is exactly what makes it tractable for AI code generation. The framework's own framing supports this reading: opinionated and AI agent-first are presented together, and guardrails only make sense if the number of acceptable shapes is small.

If you have an existing MongoDB deployment and just want auth and monitoring handled, the assembled route keeps your data layer untouched. If you are starting from nothing and want the four concerns wired together before you write a feature, Modelence's premise is that you get there faster. Neither is universally right; the deciding factor is how much of the stack you have already committed to.

Maintenance, upgrades and what to check before you commit

Upgrade cost on a pre-1.0 framework is mostly the cost of reading release notes. The feed shows patch releases (0.24.1) and minor releases (0.25.0) landing within days of each other, with release candidates published before the stable tag. That cadence suggests active development and also suggests you should not float on a caret range in production without checking what changed. The README does not describe a deprecation policy or a support window for older versions, so the release notes themselves are the only signal available.

For contributors, the maintenance picture is clearer. The README states the policy directly: bug fixes and small improvements as pull requests, and changes to the core runtime or public API surface starting with an issue. The local build workflow is three commands, and the documented reset (delete node_modules and package-lock.json, reinstall, rebuild) is the standard escape when a local dependency tree goes bad. The note that the regenerated lockfile should not be committed unless requested is a small but real constraint on how you work in the repository.

On licensing, the only fact available is that the repository's licence field reads NOASSERTION. That is not a licence grant and it is not something to interpret. Before you put Modelence in a production dependency list, read the licence file in the repository and, if the terms are unclear or incompatible with how you distribute software, get your own advice. This article cannot substitute for that, and the repository as supplied does not answer the question.

The practical next step is small: run npx create-modelence-app@latest my-app, read the generated configuration files, and see whether the auth and database setup they contain matches what you would have chosen. If it does, the framework is doing what it claims. If it does not, you have learned that before writing any application code.

Editorial conclusion

Adopt Modelence if you want a single TypeScript package that already contains auth, a MongoDB-backed data layer, scheduled jobs and monitoring, and you are willing to accept the framework's opinions in exchange for not assembling those pieces yourself. Do not adopt it if you need a documented alternative to the hosted App Builder, or if you require a clear open source licence statement, because the repository is marked NOASSERTION and the README does not resolve it. Verify three things before committing: the actual licence text in the repository, whether the npm package name and version you install matches the modelence@0.25.0 line in the release feed, and whether create-modelence-app scaffolds a project you can run entirely offline with npm run dev.

Official sources

  1. Issues
  2. modelence/modelence on GitHub
  3. Project website
  4. README
  5. Releases
Community notes

Community notes