Event app for attendees and organisers. Next.js, TypeScript and Firebase (Google login and Firestore).
Attendees log in with Google, swipe through events in Explore (right to save, left to skip), join from Saved in one tap or with a 6-digit code or the host's QR, then get the event's Wi-Fi, people, speakers, schedule and feedback. They check in by scanning the code on the room's screen and collect stamps in their pass.
Organisers log in on a separate page to add events, speakers, sessions and Wi-Fi, import registration lists, run check-in and download everything as CSV.
npm install
npm run devOpen http://localhost:5191. With no Firebase settings it runs in demo mode: both logins work and data stays in your browser.
- Code: https://github.com/incial/gather (
mainis the source of truth) - Website (Vercel project
gatherapp-ten): https://gatherapp-ten.vercel.app - Database and Google login (Firebase project
ie-fdp-2026, display name Gather, Mumbai) - Update the live site: push to
main, then the owner of thegatherapp-tenVercel project deploys it (or runnpm run deployfrom a copy linked to that project)
Read DATABASE-PLAN.md first. Nothing touches a real database until that plan is approved.
- Firebase: at https://console.firebase.google.com create a new project, add a Web app, turn on Authentication with Google, and create a Firestore database.
- Settings: copy
.env.exampleto.env.localand paste the web app's values. Don't setNEXT_PUBLIC_USE_EMULATORon a live site. - Security rules: after approval, run
npx firebase login,npx firebase use <project-id>, thennpm run deploy:rules. - First organiser: in Firestore, add a document to the
organiserscollection with your Google email as the document ID. Add more people from the Team button. - Hosting: import this folder to https://vercel.com, set its Root Directory to
gatherif it's in a larger repo, and add the sameNEXT_PUBLIC_FIREBASE_*values as environment variables. - Allow the domain: in Firebase, go to Authentication > Settings > Authorized domains and add your Vercel domain.
- Open Schedule > Run check-in on the room's laptop and leave that tab in front. Codes change every 30 seconds and stop working if the page is closed or the tab is left in the background.
- Camera scanning needs HTTPS, which Vercel provides.
- Use a guest Wi-Fi network. Everyone who joins can see the password.
- Download Data & CSV > Download all after the event as a backup.
npm testnpm run test:rulestest:rules runs the security rules on a local emulator and needs Java 21+. It can't reach a real project.