/waitlist-sample-app

Waitlist Sample App using Descope Flows and AirTable

Primary LanguageJavaScriptMIT LicenseMIT

waitlist

A Better Waitlist

Implement a Waitlist app with Descope Flows and Airtable.

📝 Table of Contents

  1. Features
  2. Installation
  3. Setting up Airtable
  4. Deploy

✨ Features

  • Custom Waitlist form
  • Descope email verification and authentication
  • Airtable for waitlist
  • Email notifications and a custom profile page

⚙️ Installation

  1. Clone the repository:
git clone https://github.com/descope-sample-apps/waitlist-sample-app.git
  1. Install dependencies:
npm install
  1. Setup environment variables:
REACT_APP_PROJECT_ID="YOUR_DESCOPE_PROJECT_ID"
AIRTABLE_BASE="YOUR_AIRTABLE_BASE"
PERSONAL_ACCESS_TOKEN="YOUR_AIRTABLE_PERSONAL_ACCESS_TOKEN"
  • REACT_APP_PROJECT_ID: is your Descope Project ID and can be found in your Descope's account under the Project page.
  • REACT_APP_FLOW_ID: is your Descope Flow ID, of the flow you wish to use in your waitlist app.
  • AIRTABLE_BASE: can be found in the your Airtable base. Learn more here.
  • PERSONAL_ACCESS_TOKEN: you can create and personal access in Airtable here.

📦 Setting up Airtable

First, let’s set up our Airtable.

  1. Create an account in Airtable.
  2. Create a base with the fields: Email (Email), and Approved (Checkbox). Rename the table to “Registration.”


  1. Create a Personal access token to authenticate API requests. Click on your account profile → Developer Hub → Create Personal access token with the following settings.


  1. Once the token is created, save it somewhere securely because we will need it for later.
  2. We will need to use Airtable’s web API. To get familiar make sure to check out the Airtable web api documentation. In the API reference, select the Waitlist Base that we created. The API reference will also show you your Airtable base (highlighted in the image below). Be sure to copy that base somewhere because we will be using that when we deploy to Vercel.


When we deploy to Vercel we will need our Personal access token and the Airtable base id. Now let’s set up our Descope Project.

🚀 Deploy to Vercel

Deploy with Vercel

NOTE: When you deploy to Vercel, there will be errors because we did not create our Descope flow yet. Learn more about how we build the flow in the blog.

⚠️ Issue Reporting

For any issues or suggestions, feel free to open an issue in the GitHub repository.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.