elematch

Get points by finding card sets.

Play Now

Play the OG version

Screenshots

• 
• 

Tooling

• TypeScript for the game source and tests.
• Vite for bundling and the dev server.
• Phaser 3 game framework.
• pnpm as the package manager (enable with corepack enable).
• Vitest for unit tests.
• Node.js 24 LTS (see .nvmrc).

Build/Run

Install dependencies

git clone git@github.com:elematch/elematch.git
cd elematch
pnpm install

Run the development server

pnpm dev

Build the project (output in dist/)

pnpm build

pnpm build type-checks with tsc --noEmit before bundling. To type-check on its own:

pnpm typecheck

Run the tests

pnpm test

Commit convention

Commits follow the Angular Conventional Commits convention, enforced automatically by commitlint (@commitlint/config-angular) via the Husky commit-msg hook (.husky/commit-msg). This is the same convention semantic-release uses to decide version bumps (see Releases), so well-formed messages are what drive automated releases.

• Subject line: <type>(<scope>): <summary>.
  • type is lowercase and one of: build, chore, ci, docs, feat, fix, perf, refactor, revert, style, test. (chore is added on top of Angular's set for maintenance commits like chore(deps) and the semantic-release chore(release) bot — keep commitlint.config.js and this list in sync.)
  • summary is lowercase, imperative mood, no trailing period; keep the whole header ≤ 72 characters.
• Use a focused scope when useful (e.g. card, game, scene, ui, build, deps); omit it only for broad repository changes.
• The hook requires dev dependencies installed (pnpm install); bypass only in genuine emergencies with git commit --no-verify.

Examples:

feat(scene): add tutorial replay button
fix(card): correct set-matching for duplicate symbols
chore(deps): update phaser to 3.90

Releases

Versioning is fully automated by semantic-release — there are no manual version bumps. On every push to master, .github/workflows/release.yml:

1. derives the next SemVer from the Conventional Commits since the last vX.Y.Z tag (feat → minor, fix/perf → patch, !/BREAKING CHANGE: → major);
2. updates package.json and prepends a section to CHANGELOG.md, then runs pnpm build as a gate (a broken build aborts the release before anything is tagged);
3. commits those back to master, tags vX.Y.Z, and creates the GitHub Release.

The new tag triggers deploy-og.yml, which deploys og.elemat.ch with the bumped version. If the GitHub Release notes and CHANGELOG.md ever drift, pnpm release:sync-notes rewrites each release body from the changelog (requires an authenticated gh CLI).

Deploy (Cloudflare Workers)

The site is deployed as a static-assets Worker named elemat-ch (see wrangler.jsonc).

pnpm deploy            # builds, then runs `wrangler deploy`

Authenticate first with wrangler login if you have not already.

Docker

Build the docker image

git clone git@github.com:elematch/elematch.git
cd elematch
docker build -t elematch .

Run the container

docker run -d -p 80:80 elematch