Remindas

Send yourself reminders so you don't forget stuff

View Live · Report Bug

Remindas is a web app written in TypeScript using Next.js. Using it, users can create an account and set reminders for the future. At the specified date and time, an SMS message will be sent to their phone number with whatever message they decided to write.

Built With:

• 
• 
• 
• 
• 
• 

Auth and user management is handled with Clerk, with Planetscale to store user's reminder data. SMS messages are sent using Twilio's messaging API. Shadcn/ui is implemented as the UI components and all styling is in Tailwind.
Reminders are scheduled using a Vercel cron job that runs every minute. The cron job calls an API endpoint which checks the database for any reminders that are scheduled for the next minute. If any are found, the reminder is sent to the user's phone number using Twilio's messaging API. The reminder is then marked as sent.

Usage example

Using Remindas is easy. Just create an account with your google account, email or phone number,

Then add your phone number and start creating reminders

You can view and delete your scheduled or sent reminders from the Manage Reminders tab

Development setup

Installation

1. Fork and clone the repo

git clone https://github.com/FlapShatner/remindas.git

2. Install NPM packages

npm install

3. Create accounts with Planetscale, Clerk, and Twilio
4. Provide environmental variables

TWILIO_ACCOUNT_SID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_PHONE_NUMBER=+xxxxxxxxxx
DATABASE_URL='mysql://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
PLANETSCALE_USERNAME=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
CLERK_SECRET_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

5. Generate Prisma schema and push it to your Planetscale DB

npx prisma generate
npx prisma db push

5. Run the app

npm run dev

6. Deploy to host of your choice (I use Vercel)

Contributing

1. Create a new branch

git checkout -b 'your-branch-name'

2. Make changes.
3. Push your branch to the upstream repo

git push origin your-branch-name

4. 🎉 Follow the link provided to create a pull request 🎉

Meta

My Github
jordan@jrobertsweb.dev

Contributing

1. Fork it (https://github.com/yourname/yourproject/fork)
2. Create your feature branch (git checkout -b feature/fooBar)
3. Commit your changes (git commit -am 'Add some fooBar')
4. Push to the branch (git push origin feature/fooBar)
5. Create a new Pull Request