dxrating
maimai DX rating-related tools
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/gekichumai/dxrating with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/gekichumai/dxrating'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/gekichumai--dxrating)HTML
<a href="/listings/gekichumai--dxrating"><img src="/api/listings/gekichumai--dxrating/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Install dependencies
pnpm install
Set up the database
pnpm --filter @gekichumai/backend db:up
Configure environment
Copy the example env files and fill in the required values:
cp apps/backend/.env.example apps/backend/.env.local
Key variables: - `DATABASE_URL` — PostgreSQL connection string (default: `postgres://postgres:postgres@localhost:5432/dxrating`) - `BETTER_AUTH_SECRET` — Auth secret key
Start development servers
pnpm dev
This starts all apps concurrently: - Web: http://localhost:5173 - Backend: http://localhost:3000
Build
pnpm build
Lint & Format
pnpm lint # Check with oxlint pnpm lint:fix # Auto-fix lint issues pnpm format # Format with oxfmt pnpm format:check # Check formatting
Run tests
pnpm --filter @gekichumai/backend test # Backend integration tests (requires PostgreSQL) pnpm --filter @gekichumai/dxrating-web test # Web unit tests
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 178 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <img src="https://shama.dxrating.net/favicon/transparent-256x.png"
- alt="DXRating Logo"
- width="96px" />
- 
- ?label=deployment>)
- 
- 
- 
- # DXRating
- A web application for [maimai DX](https://maimai.sega.jp/) (music arcade game) providing rating calculators, song data, and community features such as tags, comments, and aliases.
- ## Usage
- [](https://testflight.apple.com/join/psw4PxSx)
- [](https://dxrating.net)
- ## Architecture
- This is a [Turborepo](https://turbo.build/repo) monorepo using **pnpm** as the package manager.
- ```
- apps/
- ├── web/ React 19 + Vite SPA (UnoCSS, MUI, wouter, TanStack Query)
- ├── backend/ Hono API server (oRPC, Drizzle ORM, PostgreSQL, Better Auth)
- └── functions/ Cloudflare Workers (edge endpoints)
- packages/
- ├── dxdata/ Pre-annotated maimai DX song & sheet metadata
- └── tsconfig/ Shared TypeScript base configuration
- scripts/
- └── annotator/ Generates annotated song metadata from various sources
- ```
- ### Apps
- - **`apps/web`** — The main frontend, serving both web and iOS (via WKWebView) variants. Built with React 19, Vite, UnoCSS, Material-UI 5, and shadcn/ui. Supports 4 languages (en, ja, zh-Hans, zh-Hant) via i18next, with an in-browser SQLite database (sql.js) for offline song data.
- - **`apps/backend`** — The API server built on Hono. Uses oRPC for type-safe API contracts (defined with Zod), Drizzle ORM with PostgreSQL 16 for persistence, and Better Auth for authentication (email/password, Google/GitHub OAuth, passkeys).
- - **`apps/functions`** — Cloudflare Workers edge functions built on Hono, mirroring select backend endpoints for lower latency.
- ### Packages
- - **`packages/dxdata`** — The legacy compatibility snapshot and TypeScript
- helpers. New native clients read the published catalog API; this package
- remains while existing web and renderer consumers migrate.
- - **`packages/tsconfig`** — Shared TypeScript configuration used across all apps and packages.
- ### Published catalog API
- `GET /api/v1/dxdata` returns the complete current catalog and its metadata in
- one schema-versioned, null-free document. The producer stores immutable bodies
- in PostgreSQL and atomically advances the `production-v1` pointer; the API never
- reconstructs the document per request or exposes stored provenance.
- The backend reads `dxdata.catalog_publications`, `dxdata.catalog_snapshots`, and
- `dxdata.catalog_build_runs`; identity translation joins the current
- `dxdata.catalog_run_songs` and `dxdata.catalog_run_sheets` memberships to
- `dxdata.canonical_songs`, `dxdata.canonical_sheets`, and
- `dxdata.song_source_mappings`.
- The endpoint supports `GET`, metadata-only `HEAD`, strong `ETag` validators,
- and `If-None-Match`. Successful responses are public and use separate browser
- and CDN stale-while-revalidate policies. Errors are `no-store`. Cloudflare
- Cache Rules for the catalog and arcade-catalog paths are owned by the
- infrastructure Terraform repository, leaving this application repository with
- a single deployment authority.
- ## Tech Stack
- | Layer | Technology |
- |-------|-----------|
- | Frontend | React 19, Vite, UnoCSS, MUI 5, wouter, TanStack Query |
- | Backend | Hono, oRPC, Drizzle ORM, PostgreSQL 16, Better Auth |
- | Edge | Cloudflare Workers, Hono |
- | Language | TypeScript 5.9, ESM throughout |
- | Monorepo | Turborepo, pnpm 10 |
- | Linting | oxlint + oxfmt |
- | Testing | Vitest |
- | Observability | PostHog, Sentry |
- ## Prerequisites
- - **Node.js** 26.12.1
- - **pnpm** 10.30.3+
- - **Docker** (for running PostgreSQL locally)
- ## Getting Started
- ### Install dependencies
- ```bash
- pnpm install
- ```
- ### Set up the database
- ```bash
- pnpm --filter @gekichumai/backend db:up
- ```
- ### Configure environment
- Copy the example env files and fill in the required values:
- ```bash
- cp apps/backend/.env.example apps/backend/.env.local
- ```
- Key variables:
- - `DATABASE_URL` — PostgreSQL connection string (default: `postgres://postgres:postgres@localhost:5432/dxrating`)
- - `BETTER_AUTH_SECRET` — Auth secret key
- ### Start development servers
- ```bash
- pnpm dev
- ```
- This starts all apps concurrently:
- - Web: http://localhost:5173
- - Backend: http://localhost:3000
- ### Build
- ```bash
- pnpm build
- ```
- ### Lint & Format
- ```bash
- pnpm lint # Check with oxlint
- pnpm lint:fix # Auto-fix lint issues
- pnpm format # Format with oxfmt
- pnpm format:check # Check formatting
- ```
- ### Run tests
- ```bash
- pnpm --filter @gekichumai/backend test # Backend integration tests (requires PostgreSQL)
- pnpm --filter @gekichumai/dxrating-web test # Web unit tests
- ```
- ## Deployment
- - **Web** — Cloudflare Pages
- - **Backend** — Docker container deployed via Coolify
- - **CI/CD** — GitHub Actions auto-tags versions on push to `main` and triggers deployments
- ## Useful Links
- - [Turborepo Documentation](https://turbo.build/repo/docs)
- - [Hono Documentation](https://hono.dev)
- - [oRPC Documentation](https://orpc.unnoq.com)
- - [Drizzle ORM Documentation](https://orm.drizzle.team)
- ## License
- The code is [MIT](LICENSE). The dxdata song and chart data ([`packages/dxdata`](packages/dxdata), `/api/v1/dxdata`) is free to use, and credit is appreciated: "Data from DXRating (dxrating.net)". See the [data notice](packages/dxdata/LICENSE). Song titles, artwork and charts belong to SEGA and their rights holders.
- ## Security
- If you find a vulnerability in the repository, please email the organization owner (`vulnerability@dxrating.net`). We kindly ask you not to disclose the detail of the vulnerability to the public before we have released a fix. Thanks for making DXRating a better site!
- ## Contributors
- This project is made possible by the following contributors. Contributions are always welcome!
- [](https://github.com/gekichumai/dxrating/graphs/contributors)
- 
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.