Skip to content

albindavidc/chronomind

Repository files navigation

⏱️ ChronoMind

A clean and modern time-management app featuring a Stopwatch and Countdown Timer. Designed for productivity, focus, and simplicity.


🌟 Features

  • Stopwatch

    • Start / Pause / Reset
    • Millisecond-accurate timing
    • Smooth UI transitions
  • Countdown Timer

    • Custom time input
    • Start / Pause / Reset
    • Audible or visual end alerts (optional depending on your features)
  • Responsive UI — Works on desktop & mobile

  • Fast — Built with Vite + React + TypeScript

  • Lightweight & Minimal design


🚀 Tech Stack

  • React
  • TypeScript
  • Vite

📦 Installation

Clone the repository:

git clone https://github.com/<your-username>/chronomind.git
cd chronomind

🧩 Run Locally

Prerequisite: Node.js installed

1️⃣ Install dependencies

npm install

2️⃣ Start the development server

npm run dev

3️⃣ Open the app

http://localhost:5173

🛠️ Build for Production

npm run build

🌐 Deployment

ChronoMind is automatically deployed using GitHub Pages through GitHub Actions.


📁 Project Structure

Directory structure:
└── albindavidc-chronomind/
    ├── README.md
    ├── App.tsx
    ├── index.html
    ├── index.tsx
    ├── metadata.json
    ├── package.json
    ├── tsconfig.json
    ├── types.ts
    ├── vite.config.ts
    ├── components/
    │   ├── CircularProgress.tsx
    │   ├── SmartSetup.tsx
    │   ├── StopwatchView.tsx
    │   ├── Tabs.tsx
    │   └── TimerView.tsx
    ├── public/
    │   └── manifest.json
    ├── services/
    │   └── geminiService.ts
    ├── utils/
    │   └── time.ts
    └── .github/
        └── workflows/
            └── deploy.yml


🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to open a pull request.


📜 License

This project is licensed under the MIT License.


Author

ChronoMind — Built by Albin David C For learning, productivity, and building clean interfaces.

About

Developed with AI Studio - Timer(tone) & Counter

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published