SVGU (short for Static, Vanity, Go URL) is a flexible and easy to use tool for creating vanity URLs for your Go projects. It allows publishing a Go module under a custom domain name, without the need to use your code forge's domain name.
For example, if you have a project hosted on GitHub, you can use SVGU to
publish it under a custom domain name, such as myproject.com/foo
instead of
github.com/myproject/foo
.
SVGU requires a configuration file, usually named DOMAINS.star
, which
describes the modules to export.
The configuration file is a Starlark script, which allows for a lot of flexibility. Starlark is a subset of Python for configuration files, and is used by the Bazel build system and others. It is a simple language, and you don't need to know Python to use it.
See the reference documentation for more information.
Once the configuration file is ready, you can run SVGU to generate the necessary files, and then publish them on your web server.
$ svgu
This will generate a dst
directory containing the files to publish.
The SVGU project is governed by a BSD-style license. The documentation is licensed under the Creative Commons Attribution 4.0 International License.