The minimal starter Program generated by phresh create.
First Program · Program authoring · Source
Phresh Program is a ready starting point: a window with pages in a sidebar, drawn with React UI in the System's Appearance, and a counter its Server keeps. The Client asks the Server for the count once, and hears every change.
client/main.tsxprovides the System, the Desktop, and React UI.client/app.tsxholds the pages: add one with a sidebar item and a case.server/main.tskeeps the counter.icon.pngis the Desktop's icon for a Program that has none yet: replace it with yours.
The repository is a complete ordinary Program and the source of the starter bundled by the CLI. It deliberately adds no application hierarchy, registered Service, or generator-specific model.
phresh createThe CLI creates a project from a verified bundled release without requiring a template checkout. Follow First Program to inspect, develop, and run the result.
bun install --frozen-lockfile
bun run verify
bun run devBuild, run the production definition, or package the Program with:
bun run build
bun run start
bun run packverify checks the source, builds both Endpoints, and validates the packaged
Program shape.
check performs static checks, build creates distributable output, and test
runs Vitest assertions from tests/. Run build before testing built artifacts.
verify runs check, build, and test in order. Operational tooling belongs
in scripts/; tests and their fixtures belong in tests/. Verification uses
the committed dependency graph without local package substitutions.
@phreshos/clibundles this repository forphresh createand owns the project command interface.@phreshos/coreowns the Program and Endpoint contracts demonstrated here.@phreshos/clientand@phreshos/serverprovide the two runtime adapters used by the Program.- PhreshOS System runs the resulting Program.
See CONTRIBUTING.md for the repository workflow and SECURITY.md for private vulnerability reporting.
Licensed under the MIT License. Copyright © 2026 Zohayr SLILEH.