MemberPass is the member platform for the Google Developer Group at Penn State (GDG@PSU). Members get a profile, an NFC membership card, and points for showing up to events. Organizers get the tools to run all of it.
Live app: https://members.gdgpsu.dev
Membership is by invitation, so there is no public sign-up page.
For members
- A profile with a photo, a short bio, and links, with privacy controls for each field
- An NFC card, plus a digital ID with a QR code for when the card isn't handy
- Points and stars for attending events: points can be spent on rewards, and stars are a lifetime total
- A spot on the public leaderboard, which they can opt out of
For organizers
- Invite members and see who has joined
- Write NFC cards with a card reader, by USB cable or Bluetooth
- Check people in and out at events
- Create events, manage rewards, and approve redemptions
Superadmins can also manage staff accounts, adjust individual member records, and read the full audit log.
For everyone
Public pages show upcoming events, the leaderboard, and any member profile that's set to public.
- A member taps their card on a reader connected to an organizer's laptop.
- The kiosk page shows the member's name and photo.
- The organizer checks it's the right person and confirms.
- The member taps again on the way out. If they stayed long enough, they earn the event's points.
A card only holds a link to the member's profile, and NFC tags can be copied. That's why a person always confirms attendance, and why tapping a card never logs anyone in or awards points on its own.
- Next.js 16, React 19, and TypeScript
- Tailwind CSS v4 and a shared component library
- Supabase for the Postgres database, sign-in, and file storage
- An ESP32 and a PN532 NFC reader, driven from the browser over a USB cable (Web Serial) or Bluetooth
- pnpm workspaces and Turborepo
You'll need Node 20.9 or newer, pnpm 11, and Docker for the local database.
1. Install dependencies and create your env files. The web app reads apps/web/.env.local, and
the scripts read .env.local in the repository root.
pnpm install
cp .env.example apps/web/.env.local
cp .env.example .env.local2. Start a local database. This runs Supabase in Docker and applies the migrations. It prints
the URLs and keys to copy into both env files, and .env.example explains each value.
pnpm dlx supabase@2.122.0 start3. Start the app. It runs at http://localhost:3000.
pnpm dev4. Create your first admin. There's no sign-up page, so this script grants the role and writes a one-time password link to a file.
pnpm db:bootstrap-admin --email you@psu.edu --role superadmin --out .local/admin-link.txtOpen that link to set a password, then set up an authenticator app, which admin pages require. Delete the file when you're done.
Writing cards and running the kiosk also need the reader hardware and Chrome or Edge, the browsers with Web Serial and Web Bluetooth. The reader plugs in with a USB cable or works over Bluetooth, and only for a signed-in organizer: it is given a key when it is flashed, and the site holds the same key. See hardware bring-up for wiring and the firmware README for flashing and setting a reader up.
| Command | What it does |
|---|---|
pnpm dev |
Run the app locally |
pnpm build |
Make a production build |
pnpm test |
Run the unit tests |
pnpm lint |
Check the code with ESLint |
pnpm typecheck |
Check types |
pnpm format:check |
Check formatting with Prettier |
pnpm e2e |
Run the browser tests against a running app |
pnpm db:verify |
Check database rules, on a disposable database only |
| Folder | What's in it |
|---|---|
apps/web |
The Next.js app |
packages/ui |
Shared design tokens and components |
packages/contracts |
Shared validation schemas and types |
supabase/migrations |
The database schema, rules, and functions |
firmware/kiosk-reader |
Firmware and tools for the card reader |
scripts |
Database checks and admin setup |
tests/e2e |
Browser tests |
docs |
Detailed documentation |
- Architecture
- Data model
- API and server actions
- Threat model
- Deployment
- Operations runbook
- Test plan and results
- Card reader protocol
- Hardware bring-up
- Backup and restore
- Design system
AGENTS.md has the working rules for AI coding agents, along with the project's current status and open items.
See CONTRIBUTING.md. To report a security problem, follow SECURITY.md rather than opening a public issue. PRIVACY.md explains what data the app keeps about members.
MIT © Google Developer Group at Penn State.