Fcos Project Documentation
About Fcos
Fcos is a minimalist productivity tool designed to enhance focus and time management. Built as a side project, it combines a Pomodoro timer with a clean, distraction-free interface to help users achieve their productivity goals.
Features
- Pomodoro Timer: Customizable work sessions (25, 45, 90 minutes) with increasing breaks (5, 10, 15 minutes).
- Dark Mode: Toggle between light and dark themes for comfort.
- Simple Controls: Start, pause, stop, and add time with intuitive buttons.
- Responsive Design: Adapts seamlessly to desktop only.
How to Use
- Start a Session: Click "Start" to begin a 25-minute Pomodoro session.
- Take Breaks: After each work session (25, 45, 90 minutes), enjoy auto-started breaks (5, 10, 15 minutes).
- Pause/Resume: Use "Pause" to halt and "Resume" to continue.
- Stop: Click "Stop" to reset to the initial 25-minute session.
- Add Time: Click "Add 10+ Minutes" to extend the current session.
- Toggle Theme: Use icon to switch between light and dark modes.
Contributing
Fcos welcomes contributions to enhance its functionality and user experience. Here’s how you can get involved:
- Fork the Repository: Visit FCOSO and fork it.
- Clone Locally: Run the following command in your terminal:
git clone https://github.com/elitsuv/fcos.git
- Make Changes: Edit HTML, CSS, or JS files to add features, fix bugs, or improve the design.
- Test Locally: Open
index.html in a browser to verify changes.
# No specific command needed, just open the file
- Commit & Push: Use the following commands:
git add .
git commit -m "Your message & Change ID - Eg [FCO - #21]"
git push
- Submit a Pull Request: Open a PR on GitHub with a detailed description of your changes.
Guidelines: Keep it simple, maintain the black-and-white aesthetic, and ensure cross-browser compatibility. Use GitHub Issues for questions or suggestions.