Artifact 498a59ed79bbd8c47e697e8ef242558d56b5f361bc7140bcf7682ff184e15da6:
- File
docs/site/content/docs/get-started/install.md
— part of check-in
[41dfd5c149]
at
2026-10-23 21:12:44
on branch main
— docs: landing page from the approved design, docs in its typography
The home page renders its hero figure, conformance table, version and footer from the generated data and site params. Docs pages keep Hextra with Fraunces, Inter and JetBrains Mono and rust as the accent in both themes. Add the get-started pages (install, CLI quickstart, embed in Go, first sync), the conformance reference rendered from data, and point the nav, README and old links at the new layout. (user: [email protected], size: 1626) [annotate] [blame] [check-ins using]
title: Install
weight: 10
go-libfossil is a Go module and a command. Neither needs cgo, a C toolchain or an installed fossil.
The command
go install github.com/danmestas/go-libfossil/cmd/libfossil@latest
libfossil --help
This needs the Go toolchain named in go.mod (Go 1.26 or later). The binary is statically linked and runs on Linux, macOS and Windows. Every command is listed in the CLI reference.
The library
go get github.com/danmestas/go-libfossil@latest
The library talks to SQLite through database/sql and does not pick a driver for you. Blank-import exactly one of the two driver modules in your main package; importing both panics at start-up.
| Driver | Import | Use it for |
|---|---|---|
| modernc | _ "github.com/danmestas/go-libfossil/db/driver/modernc" |
servers, command-line tools, desktop: SQLite translated to Go |
| ncruces | _ "github.com/danmestas/go-libfossil/db/driver/ncruces" |
GOOS=js and GOOS=wasip1 builds: SQLite itself as WebAssembly |
Each driver is its own module, so go get it too:
go get github.com/danmestas/go-libfossil/db/driver/modernc@latest
WebAssembly
With the ncruces driver the module builds for GOOS=js GOARCH=wasm (a browser) and GOOS=wasip1 GOARCH=wasm (any WASI Preview 1 host). CI builds the module's packages for js/wasm on every change. The wasm example builds and runs a WASI module.