Skip to content

Repository files navigation


⚫️ shadcn-ui



What is Fall Timer?

Fall Timer is a cozy pomodoro-style focus timer inspired by autumn. It helps you work deeply and rest fully with warm fall visuals, ambient sounds (leaves rustling, soft rain), and easy-to-use session controls to adjust your time, it even has a notepad for you to note things.

On mobile however there is only a timer nothing else as the screen size is small.

Here is a video showcasing the platform in action.

Features

  • Notepad for noting (markdown supported)
  • Configure durations for all timers
  • Ambient sound toggles (wind, rain, crackling fire, leaves)
  • Notification & sound alerts when sessions end
  • Dark and Light mode switching

Self Hosting Guide

Prerequisites

  • Node.js 20 or later
  • npm or bun package manager

Installation

  1. Clone the repository:
git clone https://github.com/avalynndev/fall-timer.git
cd fall-timer
  1. Install dependencies:
npm install
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 in your browser

Building for Production

npm run build
npm start

By following these steps, you can host the Fall Timer web app on your own server and make it accessible to users.

Deploy with Vercel

Notes and Credits

  • Background Images were generated using AI.
  • Sounds were found online.
  • This project was made for the theme "FALL" for Siege hackclub.

About

a pomodoro timer

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages