Skip to content

Goal-oriented Pomodoro timer that tracks your progress towards professional and personal objectives. Built with Tauri + Rust backend and React + TypeScript frontend.

License

Notifications You must be signed in to change notification settings

ginomoricheti/GrowthTimer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GrowthTimer

A goal-oriented Pomodoro application to track and achieve your professional learning objectives.

GitHub release Download for Windows License: MIT Issues Backend with Rust Frontend with React

Overview

GrowthTimer helps you structure your focus time, set measurable goals, and visualize progress — perfect for developers, students, and professionals working toward certifications or skill mastery.


Features

  • Pomodoro Timer – Fully customizable focus/break cycles.
  • Custom Goals – Define specific targets (e.g., "1000 hours of Java practice").
  • Categories – Organize sessions by type (debugging, studying, practice, etc.).
  • Visual Progress – Graphs and charts to show your journey.
  • Detailed Tracking – Every completed Pomodoro is recorded toward your goals.

Use Cases

Ideal for:

  • Developers mastering new technologies.
  • Students with structured study plans.
  • Professionals preparing for certifications.
  • Anyone with measurable learning or productivity objectives.

Tech Stack

Frontend

  • React 19 + TypeScript
  • Vite (build tooling)
  • PrimeReact (UI components)
  • FontAwesome (icons)
  • React Toastify (notifications)

Backend

  • Tauri (desktop app framework)
  • Rust (high-performance logic layer)

Development Tools

  • TypeScript (type safety)
  • ESLint (code quality)
  • Vite (fast dev server & build)

Installation

Prerequisites

Node.js >= 18.0.0
npm >= 9.0.0
Rust >= 1.70.0

Setup

# Clone the repository
git clone https://github.com/ginomoricheti/GrowthTimer.git
cd GrowthTimer

# Frontend setup
cd frontend
npm install

# Backend setup
cd ../backend
npm install -g @tauri-apps/cli

# Development mode
npm run tauri dev

# Production build
npm run tauri build

Usage

  1. Create a Project

    • Name (e.g., "Java Sr.")
    • Category (e.g., "Work")
    • Color (used in progress charts)
  2. Add a Goal

    • Example: "100 hours of Java" linked to your project
  3. Start the Timer

    • Complete Pomodoros to add progress toward your goals.
    • Track progress in real time and review stats in the right-hand panel.

Contributing

We welcome contributions!

  1. Fork the repo
  2. Create a branch: git checkout -b feature/YourFeature
  3. Commit: git commit -m "Add: YourFeature"
  4. Push: git push origin feature/YourFeature
  5. Open a Pull Request

License

Licensed under the MIT License — see LICENSE for details.


Bug Reports

Please open an issue and include:

  • Steps to reproduce
  • Expected vs actual behavior
  • Screenshots if possible

Contact

Gino Morichetti


Acknowledgments


If you enjoy GrowthTimer, please give it a star on GitHub!


About

Goal-oriented Pomodoro timer that tracks your progress towards professional and personal objectives. Built with Tauri + Rust backend and React + TypeScript frontend.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published