rommapp/romm

A beautiful, powerful, self-hosted ROM manager and player.

12kStars on the repository
12Mods indexed here, across every type
2d agoLast push, which is what freshness is scored on
AGPL-3.0Licence, which decides whether bodies are shown

backend-development

01

rommapp/romm

Skill Claude CodeCodex

Working on the RomM Python backend (backend/) — a FastAPI app with SQLAlchemy 2.0, Alembic, RQ/Redis, and Socket.IO. Use when adding or changing API endpoints, handlers, ORM models, response schemas, metadata-provider adapters, background tasks, database migrations, or backend tests. Covers the layered architecture…

12k 2d ago A 107 tokens AGPL-3.0

frontend-i18n

02

rommapp/romm

Skill Claude CodeCodex

Internationalization for the RomM frontend (both v1 and v2). Use whenever adding, renaming, or removing any user-visible string / translation key under frontend/src/locales/. Covers the enUS-is-source rule, the requirement to add every new key to ALL locale directories in the same change, namespace layout, and the…

12k 2d ago A 94 tokens AGPL-3.0

rommapp/romm

Skill Claude CodeCodex

Building or modifying components in the RomM v2 frontend (frontend/src/v2/). Use when creating/editing v2 primitives (R components in src/v2/lib/), shared composites, or feature composites — covers the three-tier model, file/folder conventions, SFC structure, import order, barrels, Storybook requirements, and v2…

12k 2d ago A 90 tokens AGPL-3.0

frontend-v2-input

04

rommapp/romm

Skill Claude CodeCodex

Universal input (mouse, touch, keyboard, gamepad) and responsive/universal-viewport layout in the RomM v2 frontend. Use when adding interactive v2 components, focus management, spatial navigation, gamepad/keyboard handling, modality-gated focus rings, breakpoints, or responsive layout. Covers useInput, focus geometry…

12k 2d ago A 102 tokens AGPL-3.0

rommapp/romm

Skill Claude CodeCodex

Cross-cutting feature patterns for the RomM v2 frontend — error/snackbar handling, loading & skeleton states, real-time Socket.IO updates, UI state persistence (URL vs localStorage vs ephemeral), pagination/infinite scroll, forms & validation, permissions (useCan), and destructive confirmations. Use when wiring up a…

12k 2d ago A 102 tokens AGPL-3.0

frontend-v2-theming

06

rommapp/romm

Skill Claude CodeCodex

Theming, design tokens, colors, and visual language in the RomM v2 frontend. Use when styling v2 components, picking colors, adding/using CSS variables, working with light/dark themes, or whenever you'd reach for a hex/rgba literal. Covers the token pipeline (src/v2/tokens/index.ts → build:tokens → tokens.css), the…

12k 2d ago A 114 tokens AGPL-3.0

review-polish

07

rommapp/romm

Skill Claude CodeCodex

The before-review and before-handoff pass for RomM, covering both stacks. First shapes the code the checks can't see — comment and docstring discipline (the single most-corrected thing in this repo), duplicated constants/types/getters, imprecise names, loose typing in tests. Then runs the verification gate that keeps…

12k 2d ago A 138 tokens AGPL-3.0

security-audit

08

rommapp/romm

Skill Claude CodeCodex

Audit a diff (a release tag range or a PR branch) for anything malicious or a serious security regression before shipping/merging. Use when asked to "check this release", "make sure nothing malicious slipped in", "security review this PR", or vet upstream/contributor changes. Covers supply chain, egress/exfiltration…

12k 2d ago B 112 tokens AGPL-3.0