Installation

Get a Verto project up and running in under two minutes.

Prerequisites

Verto requires Node.js 18+ and a package manager (npm, pnpm, or yarn).

Quick Start

1. Clone the repository

git clone https://github.com/tsaiggo/verto.git
cd verto

This gives you a Verto project with the following structure:

verto/
├── app/            # Pages and layouts (App Router)
├── components/     # Layout + MDX blocks + UI
├── content/        # MDX files for docs and blog + navigation.json
└── lib/            # MDX pipeline, Shiki config, plugins, types

2. Install dependencies

npm install

3. Start the development server

npm run dev

Your site is now running at http://localhost:3000. Open any .mdx file in the content/ directory and start writing — changes appear instantly via hot module replacement.

Verto is built on Next.js. Run npm run build to create a production build, or npm start to serve it locally.

Verto uses next.config.ts for Next.js settings and content/navigation.json for sidebar structure. No custom configuration file is needed.

Adding Content

Create a new blog post by adding an .mdx file to content/blog/:

touch content/blog/my-first-post.mdx

Add frontmatter and content:

---
title: "My First Post"
description: "Hello world from Verto"
date: "2025-12-15"
author: "Your Name"
tags: ["introduction"]
---

# My First Post

Welcome to my Verto-powered blog!

Deploying

Verto generates a fully static site. Deploy to any hosting provider that supports Next.js:

# Build for production
npm run build

# Output is in .next/

For Vercel deployments, Verto is auto-detected — just push to your repository and Vercel handles the rest. No configuration needed.

Next Steps

Learn about Inline Comments — Verto's most distinctive authoring feature
Explore block components like Callouts, Toggles, and Bookmark Cards in the Components section
Check out the Features section to learn about all available features