Zeitlist

this is a waitlist app. it uses redis. and arcjet to validate emails.

Core Functionality

• Provides a simple form for users to submit their email.
• Validates submitted emails using Arcjet before processing.
• Stores valid emails in a Redis list managed by Upstash.
• Displays a live count of total signups.

Tech Used

• Framework: Next.js
• Database: Upstash (Redis)
• Email Validation: Arcjet
• Styling: Tailwind CSS
• Language: TypeScript

Local Setup

To get this running on your machine:

1. Clone it:

   1
   git clone ``https://github.com/zeitgg/zeitlist.git`
   2
   cd zeitlist

2. Install dependencies:

   1
   bun i

3. Set up environment variables: You'll need API keys/URLs. Create a .env.local file in the root directory and dd these variables:

   1
   # Get from your Upstash dashboard
   2
   UPSTASH_REDIS_REST_URL="YOUR_UPSTASH_REDIS_URL"
   3
   UPSTASH_REDIS_REST_TOKEN="YOUR_UPSTASH_REDIS_TOKEN"
   4
   
   5
   # Get from your Arcjet dashboard
   6
   ARCJET_SITE_KEY="YOUR_ARCJET_SITE_KEY"

4. Run the dev server:

   1
   bun dev

5. Open in browser: http://localhost:3000

How it Works (Quick Overview)

1. User submits their email via the frontend.
2. The submission hits an API route (e.g., /api/waitlist/).
3. This API route first passes the email to Arcjet for validation.
4. If Arcjet approves, the email is added to a list in Redis using the Upstash SDK.
5. A separate API route (e.g., /api/waitlist/count) reads the length of the Redis list to get the current signup count.
6. The frontend fetches from the count endpoint and displays the number.

Contributing

Issues and PRs welcome.

License

MIT License