Skip to main content

​
Directory layout

my-app/
  app/                  # Pages and API routes
    layout.tsx          # Root layout (wraps all pages)
    page.tsx            # Home page (/)
    about/
      page.mdx          # /about (MDX page)
    blog/
      [slug]/
        page.tsx         # /blog/:slug (dynamic route)
    api/
      chat/
        route.ts         # POST /api/chat
  agents/               # AI agent definitions (auto-discovered)
    assistant.ts
  tools/                # Tool definitions (auto-discovered)
    get-weather.ts
  prompts/              # Prompt definitions (auto-discovered)
    assistant.ts
  workflows/            # Workflow definitions (auto-discovered)
    data-pipeline.ts
  resources/            # MCP resource definitions (auto-discovered)
    docs.ts
  components/           # Shared React components
    Header.tsx
  lib/                  # Shared utilities
    auth.ts
  content/              # Static content (MDX posts, data files)
    posts/
      hello-world.mdx
  public/               # Static assets served as-is
    favicon.ico
  styles/               # Global stylesheets
    globals.css
  veryfront.config.ts   # Framework configuration (optional)
  package.json

​
Routing directories

​
app/

The app/ directory contains pages and API routes. The file path maps directly to the URL:
FileURL
app/page.tsx/
app/about/page.tsx/about
app/blog/[slug]/page.tsx/blog/:slug
app/api/users/route.ts/api/users
Pages use page.tsx (or page.mdx). API routes use route.ts. Layouts use layout.tsx. See Pages & Routing for the full routing system.

​
Auto-discovered directories

These directories are scanned automatically at startup. Every file with a default export is registered.
DirectoryPurposeImport
agents/AI agent definitionsveryfront/agent
tools/Tool definitions with Zod schemasveryfront/tool
prompts/Prompt templatesveryfront/prompt
workflows/Multi-step workflow DAGsveryfront/workflow
resources/MCP-exposable resourcesveryfront/resource
The filename becomes the ID. agents/assistant.ts registers as "assistant" and can be retrieved with getAgent("assistant").

​
Customizing discovery paths

Override the default directories in veryfront.config.ts: 
import { defineConfig } from "veryfront";

export default defineConfig({
  directories: {
    app: "src/app",
  },
});

​
Convention directories

These directories aren’t auto-discovered but follow standard conventions:
DirectoryPurpose
components/Shared React components
lib/Shared utilities and business logic
content/Static content (MDX, JSON, YAML)
public/Static assets served at root path
styles/Global CSS files
middleware/Custom middleware functions

​
Special files

FilePurpose
app/layout.tsxRoot layout wrapping all pages
app/error.tsxError boundary for the app
app/not-found.tsxCustom 404 page
veryfront.config.tsFramework configuration
package.jsonDependencies and metadata

​
Why flat?

Veryfront is an AI-native framework. Agents, tools, prompts, and workflows are first-class primitives, not add-ons tucked inside a subfolder. Keeping them at the project root makes them visible and accessible, just like components/ or lib/.

​
Next