A self-hosted Gitea Pages server with static hosting, route filters, and JavaScript handlers.

This project is part of Dragon's Zone HomeLab.

gitea-pages serves content from Gitea repositories and adds a small routing layer on top of normal Pages-style hosting.

It is designed for self-hosted deployments and supports:

• static file serving from a Pages branch
• JavaScript route handlers with Goja
• reverse proxy routes
• custom domains
• private page access with Gitea OAuth
• caching, storage, and event helpers for scripts

For Chinese documentation, see README_zh.md.

Requirements:

• Go 1.25+
• make

Build:

make gitea-pages

Run:

./gitea-pages -conf config.yaml

• Server configuration: config.yaml
• Page routing and security: .pages.yaml in the page branch
• JavaScript filter APIs: pkg/filters/goja/README.md

Examples are available in examples:

• examples/hello_world
• examples/js_hello_world
• examples/js_router
• examples/js_storage
• examples/js_ws
• examples/js_sse

Run tests:

make test

Run formatting:

make fmt

Run a local example:

go run ./cmd/local/main.go -path examples/js_hello_world

Licensed under Apache-2.0.