Skip to main content
Routine Optimizer is a PWA designed to help student-athletes balance their academic and athletic commitments. This guide will get you up and running quickly.

Access the App

The fastest way to start is to access the live application. Routine Optimizer is a Progressive Web App, so you can use it directly in your browser or install it on your device.
1

Open the application

Navigate to the deployed application URL in your web browser. We recommend using Chrome, Safari, or Edge for the best experience.
2

Create your account

Click Sign Up and register with your email or use social login (Google/GitHub).
// The app validates your credentials securely
- Email must be valid format
- Password must be at least 6 characters
- Username must be at least 3 characters
After registration, check your email for a verification link to activate your account.
3

Complete onboarding (4 steps)

The onboarding wizard will guide you through initial setup:Step 1: Personal Information
  • Your name and age
  • Main sport and competitive level (Amateur/Professional)
  • Academic level (High School, University, etc.)
Step 2: Academic Setup
  • Add your subjects/courses
  • Rate difficulty level (1-5) for each subject
  • Configure your class schedule
Difficulty ratings are crucial! The smart routine engine uses these to schedule demanding subjects during your peak cognitive hours.
Step 3: Activities & Schedule
  • Set training schedule and intensity
  • Configure sleep times (wake up and bedtime)
  • Set meal times (breakfast, lunch, dinner)
Step 4: Review & Confirm
  • Review your complete profile
  • Generate your first intelligent routine
Be honest with your sleep and training intensity. The AI Coach needs accurate data to prevent burnout.
4

Explore your dashboard

After onboarding, you’ll land on the Dashboard with:
  • Daily Timeline: Your day divided into smart blocks (Study, Training, Rest)
  • Load Metrics: Cognitive and Physical load indicators
  • Quick Actions: Create tasks, start Pomodoro, view calendar
  • AI Coach: Your personal assistant powered by Llama 3

Create Your First Task

Now let’s create a task and work on it with the Pomodoro timer.
1

Add a task

  1. Navigate to the Tasks section from the sidebar
  2. Click New Task button
  3. Fill in the details:
    • Title (e.g., “Complete Math Assignment”)
    • Due date
    • Priority level (Low/Medium/High)
    • Link to a subject (optional)
    • Estimated Pomodoros needed
{
  title: "Complete Math Assignment",
  status: "pending",
  priority: "high",
  dueDate: "2026-03-10",
  estimatedPomodoros: 4,
  subjectId: "calculus-101"
}
2

Start working with Pomodoro

  1. Go to the Pomodoro page
  2. Select your task from the dropdown
  3. Click Start to begin a 25-minute focus session
  4. Work until the timer completes
  5. Take a 5-minute break when prompted
The Pomodoro timer integrates with your tasks to track actual time spent. After 4 Pomodoros, you get a longer 15-minute break.
3

Use Focus Mode (optional)

For deeper concentration, activate Focus Mode (Zen):
  • Click the Focus Mode icon in the navigation
  • Enjoy an immersive full-screen experience
  • Use the procedural ambient sound generator (pink, white, or brown noise)
  • Exit by pressing ESC or clicking the close button

Talk to Your AI Coach

The AI Coach understands your specific context and can help you make better decisions.
1

Open AI Coach

Click the AI Coach icon in the navigation or from the dashboard.
2

Ask questions

Try these example questions:
  • “Should I study high-difficulty subjects after intense training?”
  • “I have an exam on Friday. How should I organize my week?”
  • “I’m feeling exhausted today. What do you recommend?”
  • “How can I improve my study-training balance?”
The AI Coach analyzes your fatigue levels, schedule, and upcoming deadlines to provide personalized recommendations.
3

Use quick action chips

The AI Coach interface includes quick action chips for common requests:
  • Request weekly planning
  • Ask for motivation
  • Get recovery tips
  • Optimize study schedule

Install as Native App (Optional)

For the best experience, install Routine Optimizer as a native app on your device.

iOS (iPhone/iPad)

  1. Open in Safari
  2. Tap the Share button
  3. Select Add to Home Screen
  4. Confirm

Android

  1. Open in Chrome
  2. Tap the menu (3 dots)
  3. Select Install app
  4. Confirm

Desktop

  1. Open in Chrome or Edge
  2. Click the install icon in the address bar
  3. Confirm installation
Once installed, the app works offline and sends you notifications for Pomodoro sessions and upcoming events.

Next Steps

Now that you’re set up, explore these powerful features:

Smart Routines

Learn how the intelligent routine engine balances your cognitive and physical load.

Academic Tracking

Manage subjects, grades, and study resources.

Habits & Goals

Build streaks and track long-term objectives.

Calendar Events

Schedule exams, matches, and important deadlines.
Having issues? Check the installation guide for troubleshooting tips or reach out to support.

Build docs developers (and LLMs) love