Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gekichumai--dxrating/badge.svg)](/listings/gekichumai--dxrating)

HTML

<a href="/listings/gekichumai--dxrating"><img src="/api/listings/gekichumai--dxrating/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

  1. <img src="https://shama.dxrating.net/favicon/transparent-256x.png"
  2. alt="DXRating Logo"
  3. width="96px" />
  4. ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/gekichumai/dxrating/release.yml)
  5. ![GitHub deployments](<https://img.shields.io/github/deployments/gekichumai/dxrating/dxrating%20(Production)?label=deployment>)
  6. ![GitHub License](https://img.shields.io/github/license/gekichumai/dxrating)
  7. ![GitHub Repo stars](https://img.shields.io/github/stars/gekichumai/dxrating?style=flat)
  8. ![GitHub contributors](https://img.shields.io/github/contributors/gekichumai/dxrating)
  9. # DXRating
  10. 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.
  11. ## Usage
  12. [![TestFlight](https://img.shields.io/badge/Join%20TestFlight%20Beta-147EFB?logo=xcode&logoColor=FFFFFF&label=iOS)](https://testflight.apple.com/join/psw4PxSx)
  13. [![Cloudflare Pages](https://img.shields.io/badge/Visit%20Production%20Site-F38020?logo=cloudflare-pages&logoColor=FFFFFF&label=Web)](https://dxrating.net)
  14. ## Architecture
  15. This is a [Turborepo](https://turbo.build/repo) monorepo using **pnpm** as the package manager.
  16. ```
  17. apps/
  18. ├── web/ React 19 + Vite SPA (UnoCSS, MUI, wouter, TanStack Query)
  19. ├── backend/ Hono API server (oRPC, Drizzle ORM, PostgreSQL, Better Auth)
  20. └── functions/ Cloudflare Workers (edge endpoints)
  21. packages/
  22. ├── dxdata/ Pre-annotated maimai DX song & sheet metadata
  23. └── tsconfig/ Shared TypeScript base configuration
  24. scripts/
  25. └── annotator/ Generates annotated song metadata from various sources
  26. ```
  27. ### Apps
  28. - **`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.
  29. - **`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).
  30. - **`apps/functions`** — Cloudflare Workers edge functions built on Hono, mirroring select backend endpoints for lower latency.
  31. ### Packages
  32. - **`packages/dxdata`** — The legacy compatibility snapshot and TypeScript
  33. helpers. New native clients read the published catalog API; this package
  34. remains while existing web and renderer consumers migrate.
  35. - **`packages/tsconfig`** — Shared TypeScript configuration used across all apps and packages.
  36. ### Published catalog API
  37. `GET /api/v1/dxdata` returns the complete current catalog and its metadata in
  38. one schema-versioned, null-free document. The producer stores immutable bodies
  39. in PostgreSQL and atomically advances the `production-v1` pointer; the API never
  40. reconstructs the document per request or exposes stored provenance.
  41. The backend reads `dxdata.catalog_publications`, `dxdata.catalog_snapshots`, and
  42. `dxdata.catalog_build_runs`; identity translation joins the current
  43. `dxdata.catalog_run_songs` and `dxdata.catalog_run_sheets` memberships to
  44. `dxdata.canonical_songs`, `dxdata.canonical_sheets`, and
  45. `dxdata.song_source_mappings`.
  46. The endpoint supports `GET`, metadata-only `HEAD`, strong `ETag` validators,
  47. and `If-None-Match`. Successful responses are public and use separate browser
  48. and CDN stale-while-revalidate policies. Errors are `no-store`. Cloudflare
  49. Cache Rules for the catalog and arcade-catalog paths are owned by the
  50. infrastructure Terraform repository, leaving this application repository with
  51. a single deployment authority.
  52. ## Tech Stack
  53. | Layer | Technology |
  54. |-------|-----------|
  55. | Frontend | React 19, Vite, UnoCSS, MUI 5, wouter, TanStack Query |
  56. | Backend | Hono, oRPC, Drizzle ORM, PostgreSQL 16, Better Auth |
  57. | Edge | Cloudflare Workers, Hono |
  58. | Language | TypeScript 5.9, ESM throughout |
  59. | Monorepo | Turborepo, pnpm 10 |
  60. | Linting | oxlint + oxfmt |
  61. | Testing | Vitest |
  62. | Observability | PostHog, Sentry |
  63. ## Prerequisites
  64. - **Node.js** 26.12.1
  65. - **pnpm** 10.30.3+
  66. - **Docker** (for running PostgreSQL locally)
  67. ## Getting Started
  68. ### Install dependencies
  69. ```bash
  70. pnpm install
  71. ```
  72. ### Set up the database
  73. ```bash
  74. pnpm --filter @gekichumai/backend db:up
  75. ```
  76. ### Configure environment
  77. Copy the example env files and fill in the required values:
  78. ```bash
  79. cp apps/backend/.env.example apps/backend/.env.local
  80. ```
  81. Key variables:
  82. - `DATABASE_URL` — PostgreSQL connection string (default: `postgres://postgres:postgres@localhost:5432/dxrating`)
  83. - `BETTER_AUTH_SECRET` — Auth secret key
  84. ### Start development servers
  85. ```bash
  86. pnpm dev
  87. ```
  88. This starts all apps concurrently:
  89. - Web: http://localhost:5173
  90. - Backend: http://localhost:3000
  91. ### Build
  92. ```bash
  93. pnpm build
  94. ```
  95. ### Lint & Format
  96. ```bash
  97. pnpm lint # Check with oxlint
  98. pnpm lint:fix # Auto-fix lint issues
  99. pnpm format # Format with oxfmt
  100. pnpm format:check # Check formatting
  101. ```
  102. ### Run tests
  103. ```bash
  104. pnpm --filter @gekichumai/backend test # Backend integration tests (requires PostgreSQL)
  105. pnpm --filter @gekichumai/dxrating-web test # Web unit tests
  106. ```
  107. ## Deployment
  108. - **Web** — Cloudflare Pages
  109. - **Backend** — Docker container deployed via Coolify
  110. - **CI/CD** — GitHub Actions auto-tags versions on push to `main` and triggers deployments
  111. ## Useful Links
  112. - [Turborepo Documentation](https://turbo.build/repo/docs)
  113. - [Hono Documentation](https://hono.dev)
  114. - [oRPC Documentation](https://orpc.unnoq.com)
  115. - [Drizzle ORM Documentation](https://orm.drizzle.team)
  116. ## License
  117. 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.
  118. ## Security
  119. 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!
  120. ## Contributors
  121. This project is made possible by the following contributors. Contributions are always welcome!
  122. [![Contributors](https://contrib.rocks/image?repo=gekichumai/dxrating)](https://github.com/gekichumai/dxrating/graphs/contributors)
  123. ![Alt](https://repobeats.axiom.co/api/embed/e1e839b6d5dca7b87ff9827a2347e8a6a19f2229.svg "Repobeats analytics image")

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.