command module
Version: v0.0.12 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Nov 15, 2022 License: MIT Imports: 10 Imported by: 0




Generate HTML pages that allow you to set "custom" or "vanity" import paths for your Go packages using the go-import meta tag (read the specs).

For example, this package import path is (instead of


  • Painless to host: it's only static files
  • Designed to be used in a CI environment: ship as single binary with no OS dependencies
  • Easy to configure and extend via a single TOML configuration file
  • Use your own template for the index and the repo pages.


  • From GitHub releases: download the binary corresponding to your OS and architecture.
  • From source (make sure $GOPATH/bin is in your $PATH):
go get


    vanity-imports [option]

    --init                  creates a sample .vanity-imports.toml config file
    -c, --config CONFIG     path to the config. Defaults to .vanity-imports.toml
    -V, --version           print version

First, create a config file.

vanity-imports --init

Generate the HTML pages


Upload the content of the dist directory to your web server or your favorite static hosting service such as GitHub Pages, OVHcloud Web Hosting or Netlify.

Configuration format

Format for the .vanity-imports.toml file.

domain = "" # required
output = "output" # default to dist
repo_template = """<golang template>""" # override the default template for the repo page
index_template = """<golang template>""" # override the default template for the index page

description = ""
extra_head = "" # extra html tags appended to the head
title = "" # required


[repos."/dyndns"] # domain + "/dyndns will be your package import path
repo = "" # required. Url to the source repository
vcs = "git"

Example usage

Check out the netlify branch to find the code behind


Generate the pages

go run .

Regenerate the pages on file changes and start a web server on http://localhost:3000.


Run the tests

go test ./...




The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL