Event RSVP Template

An open-source RSVP and guest list app built with Next.js, TypeScript and PostgreSQL, for hosts of company parties, weddings and community dinners. Guests reply coming, maybe or can't come on a private link or an open event link, with plus-ones, dietary needs and the host's own questions, and organisers get the guest list with counts, phone replies, capacity, CSV export, calendar files, and email invitations and reminders.

by Light CloudEvents and tickets

Build an event RSVP app with Next.js and PostgreSQL

Guest list for a summer party: 38 coming of 43 invited, filters by reply, and each guest with their group, reply, plus-ones, dietary needs and answers
Guest list for a summer party: 38 coming of 43 invited, filters by reply, and each guest with their group, reply, plus-ones, dietary needs and answers, on a phone

Features

  • Many events per deployment, each with a host, times, venue, dress code, reply-by date, cover photo and how many guests each person can bring
  • A private signed link per guest to reply, and change the reply until replies close, with no account
  • An optional open link anyone can reply to, which refuses an email already on the list, and a switch to list the event on the home page and to search engines
  • Replies with plus-ones and their names, dietary needs, up to five of your own questions and a message, with capacity checked under a per-event lock
  • A guest list with counts, filters, search and groups, guests added one by one or pasted from a spreadsheet, and replies recorded when they come by phone
  • Dietary needs listed for the caterers, each question's answers counted, and CSV export with every guest's private link
  • Email invitations, reminders at most once a day and reply confirmations through Resend, or copy each guest's link when no key is set
  • An .ics calendar file on event and invitation pages, Organiser and Helper roles, and two demo Manchester events

Tech stack

What you need

  • A paid plan: deploying creates a PostgreSQL database, which the Free plan does not include
  • To run it locally: Node.js 22.12 or newer, npm, and Docker for a local PostgreSQL
  • No API keys needed to start: organisers copy each guest's private link and send it themselves
  • Optional: RESEND_API_KEY and EMAIL_FROM to email invitations, reminders, reply confirmations and team invitations
  • Optional: APP_NAME for your organisation's name over the public pages, the staff area and emails (default RSVP)

About

Organisers set up events, guests, questions and the team in the staff area, and the name over every page is the APP_NAME variable; cover photos are public/images/cover-*.webp with their alt text in src/lib/images.ts, and the demo events are scripts/seed.mjs. A guest's link carries their id and an HMAC of it, so the organiser can copy it again at any time, and every yes is checked against the event's limit under a per-event lock, so two families replying for the last places at once get exactly one. Email through Resend has not been tried with a real key or in real mail clients, and reminders only go out when an organiser presses Remind, with no schedule. The demo dates are set from the first start, so on a long-lived deployment the open neighbourhood supper passes in about three weeks and the home page then shows No open events. Plus-ones are counted, not invited, there is no waiting list, the Shared table cover photo shows identifiable faces you may want to swap, and the reply rate limit is kept per instance.

FAQ

How do I collect RSVPs for an event without guests making an account?

Add your guests and send each one their private link, by email from the app or copied into a message, or switch on the event's open link and share that. Guests choose coming, maybe or can't come, add plus-ones and dietary needs, and can change their reply from the same link later.

Can guests bring a plus-one?

Yes. Set how many guests each person can bring on the event (none, one, or more for families), and change it for one guest on the guest list. People coming are counted with their plus-ones against the event's limit.

How do I send RSVP reminders?

With RESEND_API_KEY set, press Remind on the guest list: everyone with no reply or a maybe gets a short email with their link, and nobody is reminded twice in a day. Reminders are not scheduled; without email, filter the list by No reply and copy their links.

Can I export the guest list to a spreadsheet?

Yes. Export CSV gives every guest with their reply, plus-ones and names, dietary needs, each of your questions, their message and their private link, ready for Excel, Google Sheets or a mail merge.

Can I use it for wedding RSVPs?

Yes. Keep the event invitation only, so each guest replies on their own private link, set the plus-ones per guest, group guests such as Family, and add up to five questions of your own, for example a meal choice. Dietary needs and answers are counted for the caterers.

Price
Free
Framework
Next.js · JavaScript
Updated

Variables

  • AUTH_SECRETGenerated