Skip to content

Latest commit

 

History

History
409 lines (261 loc) · 12.8 KB

File metadata and controls

409 lines (261 loc) · 12.8 KB

ProjectSimple User Guide

A project and task management app for iPhone and iPad.


Table of Contents

  1. Getting Started
  2. App Navigation
  3. Managing Projects
  4. Managing Tasks
  5. Task Steps (Subtasks)
  6. Recurring Tasks
  7. Calendar View
  8. Search & Filters
  9. Archive & Completed Items
  10. PDF Export
  11. Data Backup (Export & Import)
  12. Notifications
  13. Home Screen Widgets
  14. Siri Shortcuts
  15. iPad Features

Getting Started

When you first launch ProjectSimple, a "Getting Started" project is created automatically with six tutorial tasks that walk you through the app's features. You can complete, edit, or delete these tasks as you explore.


App Navigation

The app has four main tabs at the bottom of the screen:

Tab Icon Purpose
Calendar calendar View tasks by date, see overdue items
Projects folder Browse, create, and manage projects
Search magnifyingglass Find tasks and projects with filters
Archive archivebox Access archived and completed items

On iPad, these tabs can also appear as a sidebar that you can toggle.


Managing Projects

Creating a Project

  1. Go to the Projects tab.
  2. Tap the + button (top right).
  3. Fill in the project details:
    • Name (required)
    • Description (optional)
    • Start Date and End Date
    • Category — Work, Personal, Education, Health, Finance, or Other
    • Color — Choose from six accent colors (blue, purple, orange, red, green, pink)
  4. Tap Add.

Viewing a Project

Tap any project in the list to see its detail view, which includes:

  • Project description, category, and dates
  • Progress bar showing completion percentage
  • Status badges: To Do, In Progress, and Done counts
  • Task list sorted by completion status, then priority, then due date

Editing a Project

  • Swipe left on a project row and tap the blue edit button, or
  • Open the project detail view, tap the menu (...) at the top right, and select Edit Project.

Deleting a Project

  • Swipe left on a project row and tap the red delete button.
  • A confirmation dialog will appear — this permanently deletes the project and all its tasks.

Archiving a Project

  • Swipe left on a project row and tap the orange archive button, or
  • From the project detail view menu, select Archive Project.

Archived projects are moved to the Archive tab and no longer appear in the main list.


Managing Tasks

Creating a Task

  1. Open a project's detail view.
  2. Tap the menu (...) at the top right and select Add Task.
  3. Fill in:
    • Title (required)
    • Details (optional)
    • Due Date
    • Priority — Low, Medium, or High
    • Recurrence — None, Daily, Weekly, Biweekly, Monthly, or Yearly
    • Steps — Optional subtasks (see below)
  4. Tap Add.

Changing Task Status

Each task has a status icon on its left side. Tap the icon to cycle through:

  • Not Started (empty circle)
  • In Progress (half-filled circle)
  • Completed (green checkmark)

Editing a Task

  • Swipe right on a task row to see the blue edit button, or
  • Swipe left for archive and delete options.

In the edit view you can change all fields including status, priority, recurrence, and steps.

Deleting a Task

Swipe left on a task row and tap the red delete button.

Archiving a Task

Swipe left on a task row and tap the orange archive button. Archived tasks move to the Archive tab.

Task Priority Colors

Tasks display a colored priority badge:

  • High — Red
  • Medium — Orange
  • Low — Green

Task Steps (Subtasks)

Steps let you break a task into smaller checklist items.

Adding Steps

  1. When creating or editing a task, scroll to the Steps section.
  2. Type a step title in the text field.
  3. Tap the + button to add it.
  4. Repeat for additional steps.

Managing Steps

  • Tap the checkbox next to a step to mark it complete (strikethrough appears).
  • Swipe left on a step to delete it.
  • Drag steps to reorder them.

A counter like "2/5 steps" appears on task rows when steps exist.

Steps and Recurring Tasks

When a recurring task is completed and a new occurrence is generated, all steps are copied to the new task with their completion reset — so you start fresh each cycle.


Recurring Tasks

Set a recurrence rule when creating or editing a task:

Rule Behavior
None One-time task
Daily New occurrence due the next day
Weekly New occurrence due in 7 days
Biweekly New occurrence due in 14 days
Monthly New occurrence due next month (same day)
Yearly New occurrence due next year (same day)

How it works: When you mark a recurring task as Completed, the app automatically creates a new task with the next due date. The original completed task remains in your history. The new task inherits the title, details, priority, recurrence rule, and steps (reset to uncompleted).

A repeat icon appears on recurring task rows.


Calendar View

The Calendar tab shows a monthly calendar with your tasks.

Navigating Months

Use the left (←) and right (→) arrows next to the month name to move between months.

Date Indicators

  • Blue highlight — Today's date
  • Colored dots below a date — Tasks are due on that day (dot colors match project colors, up to 3 shown)

Viewing Tasks for a Date

Tap a date to see all non-completed tasks due that day in the list below the calendar.

Overdue Tasks

When no date is selected, the calendar view shows an Overdue Tasks section listing all tasks past their due date that haven't been completed, sorted oldest first.

Tapping a Task

Tap any task row in the calendar view to navigate to its project detail view.


Search & Filters

The Search tab lets you find tasks and projects across your entire app.

Basic Search

Type in the search bar to filter by:

  • Project names and descriptions
  • Task titles and details

Results are grouped into Projects and Tasks sections.

Filtering by Priority

  1. Tap the filter icon (top right).
  2. Under Priority, select High, Medium, or Low.
  3. The filter icon fills in to indicate an active filter.

Filtering by Category

  1. Tap the filter icon.
  2. Under Category, select Work, Personal, Education, Health, Finance, or Other.

Combining Filters

You can use search text and filters together. For example, search for "meeting" with priority set to "High" to find only high-priority tasks matching "meeting".

To clear a filter, tap the same option again in the filter menu.


Archive & Completed Items

The Archive tab has two sections, toggled by a segmented control at the top:

Archived Section

Shows projects and tasks you've explicitly archived.

  • Swipe left on an archived project or task to Unarchive it (returns to active list).
  • Swipe right to Delete it permanently.

Completed Section

Shows projects where all tasks are complete, and individual completed tasks.

  • Swipe left on a completed task to Reopen it (sets status back to In Progress).
  • Swipe right to Archive it.

PDF Export

You can generate a formatted PDF report for any project.

  1. Open a project's detail view.
  2. Tap the menu (...) at the top right.
  3. Select Export as PDF.
  4. The share sheet appears — save to Files, send via AirDrop, email, print, etc.

The PDF includes:

  • Project name, description, category, and date range
  • Progress bar with completion percentage
  • Status count summary (To Do / In Progress / Done)
  • Full task list with priority indicators, status, due dates, and details

Data Backup (Export & Import)

Back up all your data as a JSON file and restore it later. This is especially useful if you need to delete and reinstall the app.

Exporting Data

  1. Go to the Projects tab.
  2. Tap the gear icon (top left).
  3. Select Export Data.
  4. The share sheet appears with a file named ProjectSimple_Backup_YYYY-MM-DD.json.
  5. Save it to Files, AirDrop it, email it, etc.

The export includes all projects, tasks, steps, and settings — active, archived, and completed.

Importing Data

  1. Go to the Projects tab.
  2. Tap the gear icon (top left).
  3. Select Import Data.
  4. Pick a .json backup file from the file picker.
  5. A confirmation alert shows how many projects were imported.

Important notes:

  • Import is additive — imported projects are added alongside existing data, not replacing it.
  • Imported items get fresh IDs, so you can import the same backup multiple times without conflicts.
  • If you want a clean restore, delete existing projects first before importing.

Notifications

ProjectSimple can send reminders for upcoming tasks and project deadlines.

Enabling Notifications

The app will request notification permission on first launch. You can also manage this in Settings > ProjectSimple > Notifications.

When Notifications Are Sent

Trigger Timing
Task due date Day of at 9:00 AM
Task due soon 5 days before at 9:00 AM
Project end date Day of at 9:00 AM
Project end soon 5 days before at 9:00 AM

Completed tasks and archived projects do not generate notifications.

Badge Count

The app icon badge shows the total number of overdue tasks plus tasks due today.


Home Screen Widgets

ProjectSimple offers widgets to see your tasks at a glance without opening the app.

Adding a Widget

  1. Long-press your home screen and tap + (top left).
  2. Search for ProjectSimple.
  3. Choose a widget size and tap Add Widget.

Available Widgets

Widget Size What It Shows
Overdue Tasks Small Overdue count with up to 3 task titles, sorted by priority
Overdue Tasks Medium Overdue count, up to 4 tasks with project names and priority dots
Lock Screen Circular Overdue task count
Lock Screen Rectangular Up to 2 overdue task titles

Tapping any widget opens the app to the Calendar view.

Widgets refresh automatically at midnight and whenever you make changes in the app.


Siri Shortcuts

You can use Siri voice commands and the Shortcuts app with ProjectSimple.

Available Commands

Command What It Does
"Create a new project in ProjectSimple" Opens the app to the Add Project screen
"Add a task in [Project Name]" Opens the specific project with the Add Task screen
"Show overdue tasks in ProjectSimple" Siri reads out up to 5 overdue tasks (no need to open the app)
"Task summary in ProjectSimple" Siri tells you how many active, overdue, and due-today tasks you have
"Mark [Task Name] done in ProjectSimple" Marks a specific task as completed (handles recurrence automatically)

Using with Shortcuts App

All five intents are available in the Shortcuts app, letting you build custom automations — for example, a morning routine shortcut that reads your task summary.


iPad Features

ProjectSimple adapts its layout for the larger iPad screen.

Sidebar Navigation

The bottom tab bar transforms into a collapsible sidebar on iPad. Tap the sidebar button to toggle between sidebar and tab bar views.

Split View for Projects

The Projects tab uses a two-column layout:

  • Left column — Project list (sidebar)
  • Right column — Selected project's detail view

Calendar Split Layout

In landscape orientation on iPad, the Calendar tab shows a side-by-side layout:

  • Left side — Calendar grid
  • Right side — Task list for the selected date

Multitasking

ProjectSimple supports iPad multitasking modes (Split View and Slide Over).


Tips & Tricks

  • Quick status change: Tap the status icon on any task to cycle through statuses without opening the edit view.
  • Swipe gestures: Swipe right to edit, swipe left to archive or delete — works on both project and task rows.
  • Overdue at a glance: Check the Calendar tab with no date selected to see all overdue tasks in one list.
  • Backup before testing: Use Export Data before deleting the app to preserve your test data.
  • Widget for accountability: Add the medium home screen widget to always see your overdue tasks front and center.
  • Siri for quick checks: Ask Siri for your task summary without even picking up your phone — works great with AirPods.