GitHub template

One binary, SQLite, and the admin apps wired in

Accounts, data, jobs, live updates, metrics, and admin tools run in one process, so there is one thing to deploy.

Public

cargo generate --git https://github.com/unified-field-dev/unified-field-embedded --allow-commands

Apps launcher listing Valence, Boson, Chronon, Photon, Spectra and other admin apps — Every admin app in one launcher, behind one sign-in.

Processes

Database

SQLite

Admin apps

Port

3000

How it runs

serverone binary · :3000

ValenceBosonChrononPhotonSpectraHiggsLepton (accounts)GaugeNeutrinoMesonTagNotifications

data/*.sqlite3 · one file per runtime

Each runtime keeps its own SQLite file, so jobs, events and analytics never share a database with your app data.

What it comes wired with

Data and work

SQLite/valence

SQLite/boson

SQLite/chronon

SQLite/photon

SQLite/spectra

Request context

Product shell

Lepton

Accounts/user

Gauge

Permissions/permission

Neutrino

Secrets/secrets

Notifications

Inbox/notifications

Welcome

First run/welcome

Extras

Orbital

Component preview/orbital

Meson

Files

Tag

Tags/tag

Counter demo

Example app/counter

Get started

1
Install cargo-generate
cargo install cargo-generate
2
Generate your app
cargo generate --git https://github.com/unified-field-dev/unified-field-embedded --allow-commands cd <project-name>
3
Set a dev-only Photon key
export PHOTON_TRANSPORT_KEY="$(openssl rand -base64 32)"
4
Run it
cargo leptos watch --split # open http://127.0.0.1:3000

Change what's wired in

Swap or turn off a runtime

Each runtime has its own builder. Point Boson, Chronon, Photon or Spectra at a different store, or leave one out.

Add your domain code

UI routes, workers and Valence models each have a place beside the shell, so your code stays out of the host glue.

Swap or disable a runtime ↗Where to put domain code ↗

Compare templates

	Embedded	Remote fleet
Best for	Best for one or several small applications with a limited number of users.	Best for large deployments: many medium to large applications, or a large number of users.
Processes	One binary	7+ services (see topology)
Databases	SQLite	Postgres, Redis, Fluvio, ClickHouse
Database isolation	One SQLite file per runtime, in one process	Its own database per runtime, each run as its own application
Admin apps	Valence, Boson, Chronon, Photon, Spectra, permissions, secrets, accounts, notifications	Same admin apps as Embedded, plus Nucleus
Deploy	One binary on any machine	AWS scripts, with Gluon running the applications and Docker containers
Automatic deployer	Not included	Planned
Availability	Public	Private preview

See Remote fleet →