mirror of https://github.com/0x2E/fusion.git synced 2026-05-19 18:30:35 +00:00

Files

T

Yuan 3bcf7b765b feat(frontend): add i18n infrastructure and translation coverage

Introduce shared locale messages with lazy loading across key frontend screens and persist user language preferences. Add i18n dictionary validation in scripts/CI and document the feature and check command in README.

2026-02-12 21:43:59 +08:00

2.8 KiB

Raw Blame History

Fusion

A lightweight RSS reader.

Features

Feed organization with groups, unread tracking, bookmarks, and search
RSS/Atom parsing with feed discovery support
Responsive web UI with keyboard shortcuts and PWA support
Self-hosting friendly: single binary or Docker deployment
No AI features by design: just a focused, distraction-free RSS experience
Built-in i18n (English, Chinese, German, French, Spanish, Russian, Portuguese, Swedish)

Quick Start (Docker)

latest is the latest release.

main is the latest development build.

docker run -it -d -p 8080:8080 \
  -v $(pwd)/fusion:/data \
  -e FUSION_PASSWORD="fusion" \
  ghcr.io/0x2e/fusion:latest

Open http://localhost:8080.

Docker Compose example:

version: "3"
services:
  fusion:
    image: ghcr.io/0x2e/fusion:latest
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - FUSION_PASSWORD=fusion
    restart: unless-stopped
    volumes:
      - ./data:/data

Other Installation Options

Pre-built binary: download from Releases
Build from source: see Contributing
One-click deployment:
- Deploy on Fly.io
- Deploy on Railway (community maintained)

Configuration

All config keys are documented in .env.example.

Common keys:

FUSION_DB_PATH (default fusion.db)
FUSION_PASSWORD (required unless FUSION_ALLOW_EMPTY_PASSWORD=true)
FUSION_PORT (default 8080)
FUSION_PULL_INTERVAL, FUSION_PULL_TIMEOUT, FUSION_PULL_CONCURRENCY
FUSION_CORS_ALLOWED_ORIGINS, FUSION_TRUSTED_PROXIES
FUSION_OIDC_* for optional SSO

Legacy env names (DB, PASSWORD, PORT) are still accepted for backward compatibility.

Documentation

API contract (OpenAPI): docs/openapi.yaml
Backend design: docs/backend-design.md
Frontend design: docs/frontend-design.md
Legacy schema reference (kept for migration work): docs/old-database-schema.md

Development

Requirements: Go 1.25+, Node.js 24+, pnpm
Helpful commands are in scripts.sh
Frontend i18n key check: cd frontend && npm run check:i18n

Example:

./scripts.sh build

Contributing

Contributions are welcome. Please read Contributing Guidelines before opening a PR.

Credits

Feed parsing powered by gofeed

2.8 KiB Raw Blame History