How to setup a new blog with vāk

Starting from scratch? Here's how to create a new blog with vāk.

Steps

1. Create a new directory for your blog:

mkdir my-blog
cd my-blog

2. Download vaak.cjs from the releases page

3. Make it executable:

chmod +x vaak.cjs

4. Initialize your blog:

./vaak.cjs init

This creates everything you need:

my-blog/
├── posts/          # Your markdown posts
├── templates/      # HTML templates (index, post, archive, etc.)
├── images/         # Image assets
├── js/             # JavaScript files
└── public/         # Generated blog (after build)

Optional: Add vāk to your PATH

For easier access, add an alias to your shell config:

# Add to ~/.bashrc or ~/.zshrc
alias vāk=/path/to/vaak.cjs

Now you can run vāk build from anywhere.

Next steps

• Write your first post
• Build and publish your blog