Fochus

Manage Your Productivity and Focus Time

Fochus is a modern, all-in-one personal productivity suite designed to help you stay organized and focused. It combines task management, note-taking, and a Pomodoro timer into a single, sleek, and intuitive interface.

Developer: Eren Çakar

Features • Installation • FAQ • License

---

App Preview

Fochus comes with an eye-friendly dark mode and a spacious light mode. You can use the system theme or select manually according to your preference.

Light and Dark Mode

Stylish and focus-enhancing Dark Mode


Clean and spacious Light Mode

---

Installation

You can use Docker (recommended) or manual installation methods to run the project.

Prerequisites

• Node.js (v18 or higher)
• Docker Desktop
• Git

Option 1: Quick Setup with Docker (Recommended)

1. Clone the repository

   git clone https://github.com/sudoeren/fochus.git
   cd fochus

2. Set Environment Variables Copy example files:

   cp .env.example .env
   cp backend/.env.example backend/.env

   ⚠️ Important Security Warning: After creating the .env files, make sure to change the JWT_SECRET value to a hard-to-guess, random string of characters. Default values are for development environment only.

3. Start the App

   docker-compose up -d --build

   The application will start running at http://localhost:5173.

Option 2: Manual Installation

Backend Setup

1. Go to the backend folder:

   cd backend

2. Install dependencies:

   npm install

3. Create the database and configure the DATABASE_URL in the backend/.env file.

4. Run migrations:

   npx prisma migrate dev

5. Start the server:

   npm run dev

Frontend Setup

1. Open a new terminal and return to the main directory:

   cd ..

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

---

Spotlight: Everything at Your Fingertips

Don't get lost in the app! Access your notes, tasks, and settings in seconds with the Spotlight feature (/ key).

---

Features

Fochus is developed with user experience and efficiency in mind.

Smart Notes

• Rich Text Editor: Format and detail your notes.
• Pinning & Organization: Keep important notes at the top.
• Trash System: Safely restore deleted notes or delete them permanently.
• Task Integration: Link your notes directly with your tasks.

Advanced Task Management

• Custom Lists: Separate tasks into project-based lists and use color codes.
• Recurring Tasks: Create daily, weekly, or monthly routines.
• Drag & Drop: Easily sort tasks with @hello-pangea/dnd.
• Subtasks: Break down complex jobs into manageable small parts.
• Smart Statuses: Track Pending, Completed, or Deferred jobs.

Integrated Pomodoro Timer

• Focus Modes: Built-in timer for Work, Short Break, and Long Break.
• Session Tracking: Automatically save sessions to track your productivity history.
• Distraction-Free Interface: Simplified view to help you stay in the flow.

---

FAQ

Q: What are the main keyboard shortcuts?
A: You can open the Spotlight with the / key to quickly access all features and search your data.

Q: Where is my data stored?
A: Your data is stored securely in a local PostgreSQL database when using Docker or manual setup. Fochus also supports manual data backup and restore via the Settings page.

Q: Can I customize the Pomodoro timer?
A: Yes! You can switch between Work, Short Break, and Long Break modes. Future updates will include custom duration settings.

Q: Is there a mobile version?
A: Fochus is currently optimized for desktop use, but the interface is responsive. A dedicated mobile view is in our roadmap.

---

License

Distributed under the MIT License. See LICENSE file for more information.

---

Developed by Eren Çakar