miniCycle User Manual
Getting Started
Welcome to miniCycle! This user manual will guide you through the features and functionalities of the app.
miniCycle is a routine manager that handles your repeatable tasks differently than traditional to-do apps. Most task managers treat each task as a one-off item and collect your personal data. miniCycle is different — it's a privacy-focused workflow tool that organizes your tasks into routines. When you complete all your tasks, the cycle is completed and they automatically reset so you can tackle them again. It's perfect for daily routines, weekly goals, and recurring habits.
- Tap the + button to add a task or create a new routine
- Check off tasks as you complete them
- When all tasks are completed, the routine automatically resets (in Auto Cycle mode)
- Swipe left/right to switch between Task View and Stats Panel
Managing Tasks
Adding Tasks
Tap the + button and select "Add Task" from the menu. Enter your task name and it will appear at the bottom of your list.
Completing Tasks
Tap the checkbox next to a task to mark it as complete. You can also undo a completion by tapping the checkbox again. Undo/redo is available for recent actions.
Cycle Complete
When all tasks are completed, a cycle complete animation plays and your tasks reset automatically (in Auto Cycle mode). Your cycle count increases with each completion.
Reordering Tasks
Drag and drop tasks to reorder them, or use the move arrows if enabled in Settings. Your preferred order is saved automatically.
Task Options
Long-press a task (or use the three-dots menu) to reveal task option buttons. Available buttons include customize (-/+), priority, edit, delete, recurring, due date, reminders, and marked for removal. You can choose which buttons appear using the Customize Task Options panel.
High Priority Tasks
Mark important tasks with the priority button. Priority tasks display a red left border to help you focus on what matters most.
Editing Tasks
Tap the edit button in task options to rename a task. Press Save to confirm or Cancel to discard changes.
Due Dates
Tap the calendar icon in task options to set a due date. The date picker appears inline on the task. Due dates must be enabled in Customize Task Options first.
- Due dates appear as badges below the task name
- Overdue tasks are visually highlighted
Marked for Removal
The ❌ button in task options marks a task for automatic deletion. When enabled, the task is removed when the cycle resets (in Auto/Manual Cycle mode) or when tasks are cleared (in To-Do Mode). This is useful for temporary tasks you only need for one cycle. The button must be enabled in Customize Task Options.
Reminders
Enable reminders to get browser notifications about pending tasks. Make sure your browser allows notifications from miniCycle.
Recurring Tasks
Set up tasks that repeat automatically:
- Hourly: Reappears every hour
- Daily: Reappears every day
- Weekly: Reappears every week
- Biweekly: Reappears every two weeks
- Monthly: Reappears every month
- Yearly: Reappears every year
- Specific dates: Choose exact dates for the task to appear
Access recurring task settings through the hamburger menu (☰) → Recurring, or through task option buttons on individual tasks.
Completed Tasks
In Settings, you can choose to collapse completed tasks into a separate section at the bottom of your task list. This keeps your active tasks front and center while still showing what you've accomplished.
Cycle Modes
miniCycle offers three different modes for how your routines behave:
Auto Cycle Mode
When enabled, all tasks automatically reset to incomplete once you finish everything. This is perfect for daily routines and recurring habits. Your cycle count increases with each completion.
Manual Cycle Mode
Tasks only reset when you manually tap the "Complete Cycle" button. You can press it at any time — it will complete any remaining tasks, increment your cycle count, and reset all tasks to incomplete. This gives you full control over when a new cycle begins.
To-Do Mode
Completed tasks are removed instead of reset. Works like a traditional to-do list — perfect for one-time tasks, shopping lists, or projects.
Cleared Tasks
In To-Do Mode, tasks that are cleared aren't gone forever. You can view your cleared tasks history and restore any task you need back into your routine. See History for how to view and recreate cleared tasks.
Managing Routines
Create different routines for different areas of your life:
- Work Tasks: Professional to-dos and projects
- Home Routine: Household tasks and maintenance
- Fitness Goals: Exercise routines and health habits
- Study Plan: Learning objectives and skill development
Routine Switcher
Access the routine switcher through the folder icon or hamburger menu (☰) → "Open Existing Routine":
- Browse and select from your existing routines
- Preview routine contents before switching — tasks appear in a preview window when you select a routine
- Double-tap a routine to open it immediately without pressing the Open button
- Double-tap the preview pane to pop it out as a full review modal showing all tasks and completion status
- Rename or delete routines using the action buttons
- See storage usage for each routine
Creating New Routines
Tap the + button and select "Create New Routine", or use the hamburger menu (☰) → "New Routine". Give your routine a name and start adding tasks.
Duplicating Routines
Create a copy of any routine using the hamburger menu (☰) → Routine Actions → "Duplicate", or by tapping the copy icon in the routine switcher. The duplicate is created with the same tasks and settings as the original.
Bulk Task Actions
Access bulk operations through the hamburger menu (☰) → Task Actions & Features:
- Uncheck All: Reset all tasks to incomplete
- Delete All: Remove all tasks from the current routine
Importing Routines
Import .mcyc files from other devices or users using the hamburger menu (☰) → Routine Actions → "Import", or the "Import From External" button in the routine switcher. You can also drag and drop .mcyc files directly into the app window.
If miniCycle is installed as a PWA (see below), you can open .mcyc files directly from your device's file manager and they will be imported automatically.
Installing as a PWA
miniCycle can be installed to your home screen or desktop for a native app-like experience. To install:
- Mobile (iOS Safari): Tap the Share button → "Add to Home Screen"
- Mobile (Chrome/Edge): Tap the browser menu → "Install app" or "Add to Home Screen"
- Desktop (Chrome/Edge): Look for the install icon in the address bar, or use the browser menu → "Install miniCycle"
A notification may also appear after using the app for a short time, prompting you to install. Once installed, miniCycle works offline and can open .mcyc files directly.
Statistics & Achievements
Performance Tracking
- Cycle Count: How many times you've completed this routine
- Tasks Completed: Total tasks you've checked off
- Progress Ring: Visual indicator of current cycle progress
Milestone Badges
Earn badges by completing cycles or clearing tasks — whichever milestone you reach first unlocks the badge:
- Habit Tracker 🔥 (5 cycles / 5 tasks): First milestone — unlocks Habit Tracker vocabulary theme
- Fitness 💪 (25 cycles / 125 tasks): Getting consistent — unlocks Fitness vocabulary theme
- Scholar 📚 (50 cycles / 250 tasks): Building momentum — unlocks Scholar vocabulary theme
- Cleaning 🧹 (75 cycles / 375 tasks): Dedicated user — unlocks Cleaning vocabulary theme
- Crowned 👑 (100 cycles / 500 tasks): Champion status — unlocks a mini-game
Achievements Page
Tap any badge in the Stats Panel to view the full Achievements page. This shows all tiers, your progress toward each, and which rewards you've unlocked.
Theme Unlocks
Reaching milestones unlocks vocabulary themes — specialized label sets that give a routine its own personality. The Fitness theme relabels tasks as workouts, Scholar uses study-focused language, Cleaning uses housework terms, and so on. Assign a vocabulary theme to any routine using the 🎨 button in the routine switcher. Check the Stats Panel to see your current theme and your progress toward the next unlock.
Mini-Game
Reaching the final milestone (Crowned — 100 cycles or 500 cleared tasks) unlocks a bonus mini-game accessible from the hamburger menu (☰) → Rewards & Extras.
Customization
Dark Mode
Toggle dark mode using the moon/sun icon in the lower right corner, or through Settings. Each theme has its own dark mode variant.
Themes
Vocabulary themes change the language and icons used throughout a routine. Once you've earned your first milestone (Habit Tracker at 5 cycles or 5 cleared tasks), a Themes option appears in the hamburger menu (☰) → Rewards & Extras → "Themes". You can also assign a theme to a specific routine using the 🎨 button in the routine switcher. Available themes: Classic (always available), Habit Tracker (5 cycles), Fitness (25 cycles), Scholar (50 cycles), and Cleaning (75 cycles). See Statistics & Achievements for milestone details.
Personalization
For deeper customization, open the hamburger menu (☰) → "Personalization" to access the color picker panel. This lets you:
- Customize colors for individual UI elements (task background, title, checkboxes, and more)
- Upload a custom background image
- Apply quick preset color schemes
- Save, load, export, and import your custom color presets
- Undo color changes or reset to defaults
Custom colors only apply when using the Default theme.
Task Option Buttons
Customize which buttons appear on your tasks through the Customize (-/+) button or hamburger menu (☰) → Task Options. Available per-routine options:
- Customize (-/+): Opens this customization panel
- Priority (!): Mark tasks as high priority
- Edit: Rename a task
- Delete: Remove a task
- Recurring: Set up repeating schedules
- Due Date: Set deadlines with a calendar picker
- Reminders: Enable browser notifications
- Marked for Removal: Auto-delete on cycle reset
Global options (apply to all routines):
- Move Arrows: Up/down buttons for reordering tasks
- Three-Dots Menu: Alternative to long-press for accessing options
Settings
Access Settings from the hamburger menu (☰) → Settings & Personalization → Settings. Options are organized into collapsible sections:
Display:
- Show Help Window, Show Quick Actions, Customize Task Options
Behavior:
- Scroll to New Task, Scroll to Last Task on Load, Completed Tasks display (inline or collapsed)
Data Management:
- Backup All Routines, Restore All Routines
Reset Options:
- Reset Onboarding, Reset Notification Position, Reset Recurring Default, Reset Achievements
Advanced:
- App Diagnostics & Testing, Check for Updates, Factory Reset
Responsive Design
miniCycle works seamlessly across devices — phone, tablet, or desktop. Your experience adapts to whatever screen you're using.
Data Management
Privacy & Local Storage
All your data stays on your device. Nothing is sent to external servers, so your tasks and information remain completely private.
What is Local Storage?
Local storage is a feature built into your web browser that allows websites and apps to save data directly on your device. Unlike cloud-based apps that store your information on remote servers, miniCycle keeps everything in your browser's local storage — similar to how a native app stores data on your phone. This means:
- Your data never leaves your device
- No account or login required
- Works completely offline
- No one else can access your routines
Monitoring Storage Usage
You can check how much storage your routines are using in two ways:
- Status bar: The bottom of the task view shows the current routine's size (e.g., "~3 KB")
- Routine Switcher: Open the folder icon to see the Open Routine modal. Each routine displays its storage size, and at the bottom you'll see total usage like "9 KB / 9.91 MB used" — this shows how much of your browser's available local storage miniCycle is using
Storage Limits
Most browsers provide between 5-10 MB of local storage per website. miniCycle routines are lightweight (typically 1-5 KB each), so you can create hundreds of routines before approaching any limits. If you're concerned about storage, you can export routines as .mcyc files and delete ones you no longer need.
Download & Backup
- Download Routine: Save the current routine as a .mcyc file via hamburger menu (☰) → Routine Actions → Download
- Backup All Routines: Create a complete backup of all routines and settings via Settings → Data Management
- Share .mcyc routine files with friends or colleagues
Import & Restore
- Import Routine: Load a single .mcyc file
- Restore All Routines: Restore from a complete backup
Factory Reset
Clear all data and start completely fresh if needed. This removes all routines, settings, achievements, undo/redo history, cached data, and IndexedDB databases. This action cannot be undone, so make sure to backup anything important first.
Advanced Features
Undo/Redo
Made a mistake? Use the undo button to reverse recent actions, or use Ctrl+Z / Cmd+Z on your keyboard. Redo with Ctrl+Y / Cmd+Y. Your undo history is preserved per routine.
Search & Filter
Use the search icon to filter tasks by name. A red indicator shows when a filter is active.
History
View your routine history from the Stats Panel by tapping the History button. The History panel has two tabs:
- Events: Cycle completions, achievements unlocked, and tasks cleared — with timestamps
- Cleared Tasks: Individual tasks removed in To-Do Mode. Select tasks with checkboxes and tap "Recreate Selected" to restore them to your routine.
You can also reset your routine progress (cycle count and history) from the bottom of the History panel.
About
View app version and information through the hamburger menu (☰) → "About miniCycle".
App Diagnostics
Run app health checks, verify data integrity, and view debug information through Settings → Open App Diagnostics & Testing. This includes tools for backup management, data repair, and generating debug reports if you need to troubleshoot an issue.
Keyboard Shortcuts
miniCycle is fully keyboard-accessible. Here are the available shortcuts:
General
- Ctrl+Z (Windows) / Cmd+Z (Mac): Undo last action
- Ctrl+Y or Ctrl+Shift+Z (Windows) / Cmd+Y or Cmd+Shift+Z (Mac): Redo last action
- Escape: Close any open menu or modal
- Shift+Right Arrow: Switch to Stats Panel
- Shift+Left Arrow: Switch back to Task View
Tasks
- Enter on a task checkbox or label: Toggle task completion
- Enter while editing a task name: Save changes
- Escape while editing a task name: Cancel and discard changes
Task Options
- Left/Right Arrows: Navigate between task option buttons
- Enter or Space: Activate the focused button
- Escape: Close task options and return focus to the task
Routine Switcher
- Enter while editing a routine name: Save the new name
- Escape while editing a routine name: Cancel and restore original name
Settings & Menus
- Enter or Space: Toggle settings switches and expand/collapse menu sections
- Up/Down Arrows: Navigate dropdown options
Frequently Asked Questions
How do I rename a routine?
Tap on the routine title at the top of the task list, or use the rename option in the routine switcher.
What happens if I delete a routine?
Deleted routines cannot be recovered unless you have an exported backup file (.mcyc).
Can I use miniCycle offline?
Yes! miniCycle is a Progressive Web App (PWA) that works completely offline since all data is stored locally on your device.
How do I set up recurring tasks?
Long-press a task (or use three-dots menu) and tap the recurring icon. Choose your frequency and optional time settings.
Why aren't my notifications working?
Ensure that reminders are enabled for the task, and that your browser/device allows notifications from miniCycle.
How do I backup my data?
Use Settings → Backup All Routines to create a complete backup, or use the hamburger menu → Download Routine for individual routines.
Can I sync data between devices?
Not automatically — miniCycle is privacy-focused with no cloud sync. However, you can export from one device and import to another using .mcyc files.
What's the difference between priority and due dates?
Priority marks important tasks with a visual indicator (red border). Due dates set a specific deadline and can trigger reminders.
What's the difference between routines and cycles?
A routine is the persistent checklist you create. A cycle is one complete run-through of that routine. Your cycle count tracks how many times you've completed the routine.
Where did my cleared tasks go?
In To-Do Mode, cleared tasks are saved in a history. You can view and restore them from the cleared tasks panel.
How do I reset the onboarding tutorial?
Go to Settings → Reset Onboarding to see the welcome tutorial again.