Home

Valence

valence /ˈveɪləns/ n. – the outermost electrons of an atom. The part that actually bonds with the world.

Valence is a schema-driven web framework for Node.js and PostgreSQL. One TypeScript config gives you the database tables, admin UI, REST API, validation, migrations, and first-party analytics. Minimal, audited dependencies. Zero third-party scripts on your public pages.

1,378 tests. 6 packages. Strict TypeScript. TDD from day one.

---

Where do you want to start?

I want to build something

Build Your First Site — Go from zero to a working site with an admin panel, REST API, and analytics in 30 minutes. No prior Valence knowledge needed.

I want to understand how it works

Key Concepts — Learn the mental model: config → collections → fields → hooks → access control → APIs. Everything in Valence radiates from one config file.

I want to look something up

Field Types Reference — All 18 field types with options, column mappings, and validation rules. Configuration Options — Every config property with types and defaults. CLI Reference — valence init, valence dev, valence migrate, valence build.

---

Package overview

Package	What it does	External deps
@valencets/ui	18 Web Components, OKLCH design tokens	none
@valencets/core	Router, server, client telemetry engine	neverthrow
@valencets/db	PostgreSQL queries, migrations, Result types	postgres, neverthrow, zod
@valencets/cms	Schema engine, admin UI, auth, REST API, media	lexical, argon2, zod, neverthrow
@valencets/telemetry	Beacon ingestion, daily summaries	postgres, neverthrow
@valencets/valence	CLI: init, dev, migrate, build	tsx, zod, neverthrow

Browser JS: Public pages ship zero third-party JavaScript. The admin panel uses Lexical (Meta, MIT) for rich text editing only.