Skip to main content

​
Prerequisites

  • The Veryfront CLI installed (see Installation).
  • A terminal in which you can run veryfront init.

​
Scaffold

Run veryfront init to open the project wizard: 
veryfront init test-app
cd test-app
The wizard asks which template to use. Choose a starting point directly when you already know what you want to build, or when running the command from a non-interactive script: 
# Agent app with a chat UI, tool, and AG-UI route
veryfront init support-agent --template ai-agent

# Blank full-stack app with pages and routing
veryfront init web-app --template minimal

# Durable multi-step AI pipeline
veryfront init workflow-app --template agentic-workflow

​
Choose a runtime

By default, veryfront init scaffolds projects for Node.js. Pass --runtime <node|bun|deno> to select a different JavaScript runtime: 
veryfront init test-app --template ai-agent --runtime bun
veryfront init test-app --template ai-agent --runtime deno
What this changes:
  • All runtimes get the same package.json and template files.
  • --runtime deno additionally writes a thin deno.json so deno task dev / deno task build / deno task preview work without extra setup. Deno reads npm dependencies directly from package.json via nodeModulesDir: "auto".
  • The install command and the printed next-steps match your runtime (npm install / bun install / deno install).
You can also set "runtime": "deno" in the JSON file passed to --config.

​
Use a package manager

Use these commands when you do not have the Veryfront CLI installed globally. 
npm create veryfront

​
Run the dev server

veryfront dev
Open http://localhost:3000. File changes reload the browser.

​
Inspect the scaffold

The minimal template creates: 
test-app/
  AGENTS.md        # Project guide for coding agents
  app/
    layout.tsx      # Root layout wrapping all pages
    page.tsx        # Home page (/)
    about/
      page.mdx      # /about (MDX page)
  package.json
  README.md
The ai-agent template also creates: 
test-app/
  AGENTS.md         # Project guide for coding agents
  agents/
    assistant.ts    # AI agent definition
  tools/
    calculator.ts   # Tool the agent can call
  app/
    layout.tsx
    page.tsx        # Chat UI
    api/
      ag-ui/
        route.ts    # AG-UI streaming chat endpoint
Pages live in app/. The agent template also adds root-level agents/ and tools/. For the convention behind these directories, see Framework conventions. Generate additional app and AI primitives from the project root: 
veryfront generate agent research-agent
veryfront generate tool search-docs
veryfront generate skill research
These names are examples. Use the generated files as starting points, then edit the agent instructions, tool implementation, and skill content for the workflow you are building. Every starter includes AGENTS.md. Coding agents should read that file first, then use veryfront schema --json or the Veryfront MCP tools for current CLI and project facts. Use Coding agents to connect Claude Code, Cursor, Codex, or another MCP-aware agent.

​
Verify it worked

veryfront dev prints Ready on http://localhost:3000. Open the URL and save a source file. The browser should hot-reload.