Start without signing up

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.

Terminal
npm create @valbuild@latest
# or: pnpm create @valbuild

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

Terminal
cd your-project-name
npm run dev

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.

Terminal
npx val validate

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.

Terminal
npx val connect

Or let Val host it

If you would rather not deploy it yourself, start a site Val hosts instead.