Skip to content

chore: rewrite the README, move the tests and add CI with Dependabot - #8

Merged
xinshoutw merged 6 commits into
mainfrom
chore/repo-setup
Oct 2, 2026
Merged

xinshoutw merged 6 commits into
mainfrom
chore/repo-setup

Conversation

@xinshoutw

Copy link
Copy Markdown
Collaborator

Summary

README

  • Rewritten in the format of freshman: README.md in Traditional Chinese, README-en.md in English, each linking to the other.
  • The README now has:
    • a banner and badges, including the new AGPL-3.0 license
    • an overview with a screenshot of the player's phone
    • a demo
    • quick start, environment variables (including FIVE_GROUPS) and deployment
    • running a game, the song list and scoring
    • tech stack and project layout
    • a collapsible API section
    • contributing, license and disclaimer
  • New images in .github/assets/:
    • banner.png: 2000x666, the same size as freshman's banner
    • hero.png: the player's phone
    • demo.webp: a looping preview of the demo
    • demo.mp4: the full demo video (1:43, 3.5 MB)
  • GitHub does not play videos stored in a repository inline, so the README shows the looping preview and links it to demo.mp4.

Tests

  • test.mjs moves out of the repository root to test/worker.test.mjs. npm test runs it with Node's built-in test runner.

npm, CI and Dependabot

  • package.json pins wrangler (4.146.0) as a dev dependency, so local runs, CI and Workers Builds use the same version. It adds npm run dev, npm run deploy and npm test.
  • CI runs npm ci, npm test and wrangler deploy --dry-run on pushes to main and on pull requests. An update that breaks the Worker bundle fails before it is merged.
  • Dependabot checks npm and GitHub Actions every Monday at 04:00 (Asia/Taipei), with the same settings as freshman except that it targets main. npm minor and patch updates are grouped into one PR, and so are all Actions updates.

Notes

  • This is the first deploy with a package.json. Workers Builds should install the dependencies and then deploy with the pinned wrangler.
  • npm 12 blocks the install scripts of esbuild and workerd by default. wrangler dev and the dry-run deploy work without them, so they stay blocked.
  • The Worker only changes in one code comment.

Test plan

  • npm test
  • wrangler dev and wrangler deploy --dry-run with the pinned wrangler; the dry-run uses no Cloudflare credentials
  • Both READMEs rendered through GitHub's Markdown API and checked
  • CI passes on this pull request
  • Workers Builds deploys main after the merge

- banner.png at 2000x666, the same size as the freshman banner, in the party colors with the group shapes and a record
- hero.png: the player's phone after a mock round, framed, on a transparent background
- demo.mp4: two mock rounds with the dashboard, scoreboard and a phone side by side (1:43, 1080p)
- demo.webp: a looping preview of the second round for the README, since GitHub does not play repository videos inline
…sh version

- README.md in Traditional Chinese and README-en.md in English, linked to each other
- Banner, badges, an overview with the phone hero, and a demo preview that links to the full video
- Quick start, environment variables including FIVE_GROUPS, deployment, running a game, the song list, scoring, the tech stack and project layout
- The API table moves into a collapsible section, and the README ends with contributing rules and a disclaimer
…st scripts

- wrangler is a pinned dev dependency, so local runs, CI and Workers Builds use the same version
- npm run dev, npm run deploy and npm test replace the npx and node commands
- The install scripts npm blocks by default (esbuild, workerd) stay blocked; wrangler dev and a dry-run deploy work without them
- test.mjs moves to test/worker.test.mjs, which npm test finds with the built-in test runner
- The runner reports the result, so the closing console.log is gone
- CI runs npm ci, npm test and a dry-run deploy on pushes to main and on pull requests, so an update that breaks the bundle fails before merging
- Dependabot checks npm and GitHub Actions every Monday at 04:00 (Asia/Taipei), as in the freshman repo, grouping npm minor and patch updates and all Actions updates
- License badge and section for the AGPL-3.0 LICENSE now on main
- Node 22 or newer, as wrangler requires; npm ci, npm test, npm run dev and npm run deploy
- The tech stack and project layout list test/, package.json, CI and Dependabot
@coderabbitai

coderabbitai Bot commented Oct 2, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: 897a3898-11e4-422d-8db6-2afe47659c99

  • Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@xinshoutw
xinshoutw merged commit d6eb8d0 into main Oct 2, 2026
2 checks passed
@xinshoutw
xinshoutw deleted the chore/repo-setup branch October 2, 2026 04:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant