A static site generator for Git repositories, written in V.
gitVal is a V language implementation of gitmal. It generates browsable HTML websites from Git repositories with syntax highlighting, markdown rendering, commit history, and branch/tag navigation.
- V compiler
- chroma for syntax highlighting:
go install github.com/alecthomas/chroma/v2/cmd/chroma@latest
v -prod . -o gitvalgitval [options] <repository-path>| Option | Description | Default |
|---|---|---|
-O, --output |
Output directory | output |
-t, --theme |
Syntax highlighting theme | github |
-n, --name |
Project name | Repository directory name |
-o, --owner |
Project owner name | - |
-d, --default-branch |
Default branch | Autodetects master or main |
-b, --branches |
Pattern for branches to include | All branches |
-m, --minify |
Minify HTML output | false |
-g, --gzip |
Gzip compress output | false |
-p, --preview-themes |
Preview available themes | - |
# Generate site for current repository
gitval .
# Generate with custom project name and owner
gitval -o myusername -n myproject /path/to/repo
# Generate with dark theme
gitval -t github-dark /path/to/repo
# Generate with custom output directory
gitval -O ./public /path/to/repo
# Preview available themes
gitval -p- Syntax highlighting for 200+ languages (via chroma)
- 60+ color themes
- Markdown rendering with resolved links
- Commit history with file diffs
- Branch and tag navigation
- File tree with collapsible directories
- Responsive design
- Light and dark theme support
MIT License - see LICENSE file.