Getting started
Start on your machine, without signing up
Create a Val project from the terminal and edit it in the Studio on your own machine. No account is needed until you want your team to edit the live site, or Val to host it.
Use it for
- Trying Val before making an account
- A project you will deploy yourself, on Vercel or anywhere else
- Working on content and code together, in your editor and in git
1. Create a project
Pick a template when asked: TanStack Start or Next.js, full or minimal. You need Node 22.13 or newer.
On Windows
In PowerShell, put the package name in quotes: npm create "@valbuild@latest". Without them PowerShell reads @valbuild as a variable and the command fails.
2. Run it and open the Studio
Open the address the dev server prints, followed by /val, for example http://localhost:3000/val. That is the Studio, running against the files in your project.
3. Edit, and commit
Change something in the Studio and press Save. The change is written to the .val.ts file it came from, so you review and commit it with git, like the rest of your code. Editing the file in your editor works just as well, and the Studio follows.
Check the content
Validates every module against its schema. Run it in CI too, so broken content does not ship. See the CLI.
4. When you want more
Locally, only you can edit, and only on your machine. Connect the project when your team should edit the deployed site, or when you want Val to keep your files on its CDN.
Connect it
Opens admin.val.build/new with your repository and project filled in. This is where you sign up. See Connect your project.
Or let Val host it
If you would rather not deploy it yourself, start a site Val hosts instead.