BetterDo

Welcome to the monorepo for BetterDo — a fast, modern task manager designed to help you stay focused and organized.

I built BetterDo to simplify how I track tasks and manage projects — and I use it every day. Whether you're organizing your work, side projects, or personal goals, I hope it helps you as much as it helps me.

This project is powered by a modern tech stack — TypeScript, Node.js, React, Vite, and more — with a strong focus on developer experience. It’s easy to run locally, contribute to, and deploy in production.

Launch the app to see it in action!

Features

• ⚛️ React Application leveraging Hooks and SWR.
• 🤓 Uses TypeScript to reduce bugs and improve code satisfaction
• 👷‍♂️ Leverages a Service Worker for offline support, push notifications, and an installable PWA.
• 🧱 Uses Vite for blazing fast development and builds
• 🎼 Leverages GitHub actions for automated production deploys and testing

Getting Started

To get started, you'll need to have the following installed:

• nvm (for managing Node.js versions)
• Yarn
• Docker

Once you have these installed, you can clone the repository and run the following commands:

nvm use
yarn install
cp api/.env.example api/.env

After copying the .env file, you should edit it to set your environment variables. You can use the .env.example file as a reference.

After setting your environment variables, you can run the development server:

docker compose up -d
yarn start

If everything was successful, you should be able to access the application at the following URLs:

• http://localhost:4000/ is the API server
• http://localhost:4001/ is the Web App server
• http://localhost:4002/ is the public website (we recommend starting here)