Fokasu (焦点, 中心, 病巣, Focus)

A Pomodoro app designed to help you focus and boost productivity through the Pomodoro Technique. Fokasu offers an intuitive interface and customizable settings to help you manage your work and break periods effectively.

Table of Contents

• Features
• Installation
• Usage
• Customization
• Contributing

Features

• Customizable Settings: Adjust work duration, break duration, and the number of Pomodoro cycles to suit your workflow.
• Progress Tracking: Keep track of your completed Pomodoro sessions and current streaks.
• Clean User Interface: Minimalistic design that allows you to focus on your tasks without distractions.
• Responsive Design: Works well on both desktop and mobile devices.
• Timer & Percentage Left: A visible countdown timer with percentage left for better time management.

Installation

To run the Fokasu app locally, follow these steps:

1. Clone the Repository:

   git clone https://github.com/terrnit/fokasu.git
   cd fokasu

2. Install Dependencies: Make sure you have Node.js, npm and rustup installed. Then run:

   npm install

3. Start the Development Server:

   npm run dev

Usage

1. Set Your Preferences: Navigate to the settings to customize your work duration, break duration, and cycles.
2. Start the Timer: Press the "Start" button to begin a Pomodoro session.
3. Track Your Progress: Monitor your remaining time and percentage left visually.
4. Take Breaks: After each Pomodoro session, take a break to recharge.
5. Review Your Progress: Check your completed sessions and streaks to gauge productivity.

Customization

• Change Settings: You can modify the work duration and break duration directly from the app settings.
• Add New Features: Contributions to improve the app are welcome! Feel free to submit a PR for any changes you'd like to propose.

Contributing

If you'd like to contribute to Fokasu, please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/YourFeature).
3. Make your changes and commit them (git commit -m 'Add a new feature').
4. Push to the branch (git push origin feature/YourFeature).
5. Open a pull request with a detailed description of your changes.

Acknowledgements

• Inspired by the Pomodoro Technique, which helps improve focus and productivity.

Stack

• Typescript, React (Next 13), Zustand, Tauri and ShadcnUI

---