ra-hcp

Web application for managing Hitachi Content Platform (HCP) — S3-compatible object storage and Management API operations.

Layer	Technology
Frontend	SvelteKit 2, Svelte 5, Tailwind CSS 4, Bun
Backend	FastAPI, boto3, Python, uv
Caching	Redis
Docs	Zensical
CI/CD	Dagger, Docker, Helm

Quick Start

make setup          # Install Bun + uv and all dependencies
make run-api-mock   # Start mock backend (no HCP credentials needed)
make frontend-dev   # Start frontend dev server

For production mode with real HCP credentials: make run-api

Development

Install the git hooks once after cloning, so formatting, linting, type checks, and commit-message rules run automatically before each commit:

prek install                          # pre-commit: ruff format/lint, backend ty check
prek install --hook-type commit-msg   # commit-msg: Conventional Commits + author-trailer guard

Hooks live in prek.toml, pinned to the same tool versions CI uses, so local checks and CI agree. Run them by hand anytime with prek run --all-files, or via the Makefile: make fmt (format), make lint, make quality (format + lint + type-check). prek is a fast pre-commit runner — install it with uv tool install prek.

Documentation

• Docs site — architecture, API guide, configuration
• Storybook — component library

Requirements

• Bun — frontend runtime
• uv — Python package manager
• prek — pre-commit hook runner (uv tool install prek)
• Docker — for Redis caching (optional)

Gallery