tentislabs/tent.js

The full-stack React framework built for AI.
Data, flows, AI agents and screens in one TypeScript framework.
## Quick start
sh
npm install -g tentjs
tent new my-app
cd my-app && tent dev
The app runs at http://localhost:3000, and each save shows in the open page. With nothing installed first, npm create tent my-app makes the same project, and npx tent dev runs it.
## Why Tent.js
One framework for the whole app. Data, access rules, background flows, AI agents and React screens are defined in one TypeScript project, and one engine runs them together. No separate database service, queue, workflow tool or auth provider to wire up.
Connected both ways. Call any outside service with its keys, limits and retries handled. Offer your app's functions as an API with access keys, as an MCP server, and as a command line. Receive webhooks from other services.
Built for AI to build with. Every new project comes with an AGENTS.md, the full docs ship inside the package, and tent map and tent check give a coding agent the whole app and every problem in it at once.
Data with its rules. A table declares its columns and who may read and change its rows. The engine holds every query to those rules, and open pages update live when the data changes.
Agents and flows built in. Models, tools and long-running flows that survive restarts are part of the app, not separate services.
History of the whole app. Every change is recorded in the app's own terms, and going back brings the data with it.
Runs anywhere. tent dev on your laptop. tent start on any server, with HTTPS for your domains, and many readers beside one writer when one machine is not enough. Open source, MIT licence.
## A small app
In the project that tent new made: a table with who may read and add its rows, a query, a change, and a screen that reads the one and calls the other, in place of the first screen.
ts
// notes.ts
import { anyone, change, input, query, table, text } from 'tentjs'
export const notes = table('notes', {
columns: { body: text({ min: 1, max: 280 }) },
access: { read: anyone('the notes are public'), add: anyone('every visitor may sign') },
})
export const latestNotes = query('latestNotes', {
access: anyone('the notes are public'),
rows: notes.newest('createdAt').limit(20),
})
export const addNote = change('addNote', {
access: anyone('every visitor may sign'),
input: { body: text({ min: 1, max: 280 }) },
set: notes.add({ body: input('body') }),
})
tsx
// screens/home.tsx
import { anyone, read, screen, Form } from 'tentjs/ui'
import { addNote, latestNotes } from '../notes'
export const homeScreen = screen('homeScreen', {
path: '/',
access: anyone('the guestbook is public'),
data: { notes: read(latestNotes) },
view: ({ notes }) => (
Guestbook
Sign
{notes.map((note) => (
{note.body}
))}
),
})
tent check reports every mistake at once, each with its fix, and tent dev runs it.
## Docs
The docs ship inside the package, so they always match the version you run: