Quick start
Create and start a usable One workspace in five minutes with create / add / the first project.
Use this page to get a first usable One workspace and start the first project.
For: first-time users after installation, anyone checking whether the environment works, and people who want a fast feel for the concepts.
You will finish with: a Web project you can open in your browser.
Not installed yet? Start with Installation. Want the production-grade end-to-end path? Jump to Create a production-ready workspace.
Step 1: Create The Workspace
one create my-app
cd my-appThis creates the my-app/ directory. Run the remaining commands from inside that directory.
Step 2: Add A Web Project
The quick start uses one Web project that can be opened directly in a browser:
one add react-spa --name webone add does not download the packages the project uses. The next step does that.
Step 3: Download Dependencies And Start The Project
Before the project can run for the first time, download the packages it uses. Copy this command and run it from the workspace root; the first run can take a little while:
pnpm installAfter the download finishes, start the Web project:
pnpm -C apps/web devOpen the Local: http://localhost:.../ URL printed by the terminal. This Web example does not require preset .env values, so the quick start does not need env setup.
Done
You now have your first Web project running:
| Command | What it did |
|---|---|
one create | Created the workspace |
one add | Added one Web project |
pnpm install | Downloaded the packages the project uses |
pnpm -C apps/web dev | Started the first Web project |
Continue by goal: use one env for environment variables and one deploy for production deploys. Container image build / push is a lower-level deploy step; only open the advanced docs when you need to control it directly.
Next
Pick the path that matches your goal:
- Going to production? -> Create a production-ready workspace
- Need Infisical secrets? -> Environment variables guide
- Want Claude to run One CLI for you? -> Install skill to agent
- Need exact command details? -> CLI commands
- Do not want it? Delete the
my-app/folder.