mirror of
https://github.com/TecharoHQ/anubis.git
synced 2026-04-11 11:08:48 +00:00
df27a96f1f
* make a half-baked tarball Closes #217 Signed-off-by: Xe Iaso <me@xeiaso.net> * make two tarballs: one with just the vendor, and one with vendor and npm Signed-off-by: Xe Iaso <me@xeiaso.net> --------- Signed-off-by: Xe Iaso <me@xeiaso.net>
87 lines
2.0 KiB
Markdown
87 lines
2.0 KiB
Markdown
---
|
|
title: Local development
|
|
---
|
|
|
|
:::note
|
|
|
|
TL;DR: `npm ci && npm run dev`
|
|
|
|
:::
|
|
|
|
Anubis requires the following tools to be installed to do local development:
|
|
|
|
- [Go](https://go.dev) - the programming language that Anubis is written in
|
|
- [esbuild](https://esbuild.github.io/) - the JavaScript bundler Anubis uses for its production JS assets
|
|
- [Node.JS & NPM](https://nodejs.org/en) - manages some build dependencies
|
|
- `gzip` - compresses production JS (part of coreutils)
|
|
- `zstd` - compresses production JS
|
|
- `brotli` - compresses production JS
|
|
|
|
If you have [Homebrew](https://brew.sh) installed, you can install all the dependencies with one command:
|
|
|
|
```text
|
|
brew bundle
|
|
```
|
|
|
|
If you don't, you may need to figure out equivalents to the packages in Homebrew.
|
|
|
|
## Running Anubis locally
|
|
|
|
```text
|
|
npm run dev
|
|
```
|
|
|
|
Or to do it manually:
|
|
|
|
- Run `npm run assets` every time you change the CSS/JavaScript
|
|
- `go run ./cmd/anubis` with any CLI flags you want
|
|
|
|
## Building JS/CSS assets
|
|
|
|
```text
|
|
npm run assets
|
|
```
|
|
|
|
If you change the build process, make sure to update `build.sh` accordingly.
|
|
|
|
## Production-ready builds
|
|
|
|
```text
|
|
npm run container
|
|
```
|
|
|
|
This builds a prod-ready container image with [ko](https://ko.build). If you want to change where the container image is pushed, you need to use environment variables:
|
|
|
|
```text
|
|
DOCKER_REPO=registry.host/org/repo DOCKER_METADATA_OUTPUT_TAGS=registry.host/org/repo:latest npm run container
|
|
```
|
|
|
|
## Building packages
|
|
|
|
For more information, see [Building native packages is complicated](https://xeiaso.net/blog/2025/anubis-packaging/) and [#156: Debian, RPM, and binary tarball packages](https://github.com/TecharoHQ/anubis/issues/156).
|
|
|
|
Install `yeet`:
|
|
|
|
:::note
|
|
|
|
`yeet` will soon be moved to a dedicated TecharoHQ repository. This is currently done in a hacky way in order to get this ready for user feedback.
|
|
|
|
:::
|
|
|
|
```text
|
|
go install within.website/x/cmd/yeet@v1.13.4
|
|
```
|
|
|
|
Install the dependencies for Anubis:
|
|
|
|
```text
|
|
npm ci
|
|
go mod download
|
|
```
|
|
|
|
Build the packages into `./var`:
|
|
|
|
```text
|
|
yeet
|
|
```
|