> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oakminder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agenda Explorer

> A gesture-driven home screen that combines the best of list and calendar views without the cognitive overhead.

Most reminder apps split into two camps: plain lists that are fast to scan but give you no time context, and calendar grids that waste space on empty days. After years of switching between both, i built something that combines them. Open the app, see your day, know what to do.

<video src="https://mintcdn.com/oakminder/3nHKIe_1Z3EP6kVP/videos/Agenda.mp4?fit=max&auto=format&n=3nHKIe_1Z3EP6kVP&q=85&s=643255abe56df531151b4cccc7e43717" autoPlay muted loop playsInline controls data-path="videos/Agenda.mp4" />

## The problem with existing approaches

<Columns cols={2}>
  <Card title="List-only apps" icon={<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M2.25 5C2.25 3.48122 3.48122 2.25 5 2.25H19C20.5188 2.25 21.75 3.48122 21.75 5V19C21.75 20.5188 20.5188 21.75 19 21.75H5C3.48122 21.75 2.25 20.5188 2.25 19V5ZM8.25 8C8.25 7.58579 8.58579 7.25 9 7.25H17C17.4142 7.25 17.75 7.58579 17.75 8C17.75 8.41421 17.4142 8.75 17 8.75H9C8.58579 8.75 8.25 8.41421 8.25 8ZM9 11.25C8.58579 11.25 8.25 11.5858 8.25 12C8.25 12.4142 8.58579 12.75 9 12.75H17C17.4142 12.75 17.75 12.4142 17.75 12C17.75 11.5858 17.4142 11.25 17 11.25H9ZM8.25 16C8.25 15.5858 8.58579 15.25 9 15.25H17C17.4142 15.25 17.75 15.5858 17.75 16C17.75 16.4142 17.4142 16.75 17 16.75H9C8.58579 16.75 8.25 16.4142 8.25 16ZM7 8.75C7.41421 8.75 7.75 8.41421 7.75 8C7.75 7.58579 7.41421 7.25 7 7.25C6.58579 7.25 6.25 7.58579 6.25 8C6.25 8.41421 6.58579 8.75 7 8.75ZM7.75 12C7.75 12.4142 7.41421 12.75 7 12.75C6.58579 12.75 6.25 12.4142 6.25 12C6.25 11.5858 6.58579 11.25 7 11.25C7.41421 11.25 7.75 11.5858 7.75 12ZM7 16.75C7.41421 16.75 7.75 16.4142 7.75 16C7.75 15.5858 7.41421 15.25 7 15.25C6.58579 15.25 6.25 15.5858 6.25 16C6.25 16.4142 6.58579 16.75 7 16.75Z" fill="currentColor" fillRule="evenodd"/></svg>}>
    Fast to scan, but you lose time context. Is that dentist appointment tomorrow or next week? You have to read every line to piece together your schedule.
  </Card>

  <Card title="Calendar-only apps" icon={<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M8 1.25C8.41421 1.25 8.75 1.58579 8.75 2V3.25H15.25V2C15.25 1.58579 15.5858 1.25 16 1.25C16.4142 1.25 16.75 1.58579 16.75 2V3.25H17C19.6234 3.25 21.75 5.37665 21.75 8V9V17C21.75 19.6234 19.6234 21.75 17 21.75H7C4.37665 21.75 2.25 19.6234 2.25 17V9V8C2.25 5.37665 4.37665 3.25 7 3.25H7.25V2C7.25 1.58579 7.58579 1.25 8 1.25ZM3.75 9.25V17C3.75 18.7949 5.20507 20.25 7 20.25H17C18.7949 20.25 20.25 18.7949 20.25 17V9.25H3.75Z" fill="currentColor" fillRule="evenodd"/><path d="M8 13C8.55228 13 9 12.5523 9 12C9 11.4477 8.55228 11 8 11C7.44772 11 7 11.4477 7 12C7 12.5523 7.44772 13 8 13ZM8 17C8.55228 17 9 16.5523 9 16C9 15.4477 8.55228 15 8 15C7.44772 15 7 15.4477 7 16C7 16.5523 7.44772 17 8 17ZM13 12C13 12.5523 12.5523 13 12 13C11.4477 13 11 12.5523 11 12C11 11.4477 11.4477 11 12 11C12.5523 11 13 11.4477 13 12ZM12 17C12.5523 17 13 16.5523 13 16C13 15.4477 12.5523 15 12 15C11.4477 15 11 15.4477 11 16C11 16.5523 11.4477 17 12 17ZM17 12C17 12.5523 16.5523 13 16 13C15.4477 13 15 12.5523 15 12C15 11.4477 15.4477 11 16 11C16.5523 11 17 11.4477 17 12Z" fill="currentColor"/></svg>}>
    Good for time context, but finding a specific reminder means scrolling through empty time slots. Days with nothing scheduled still take up space.
  </Card>
</Columns>

The Agenda Explorer gives you both: the scanning speed of a list and the time awareness of a calendar, on one screen.

<Frame>
  <img src="https://mintcdn.com/oakminder/yW1NaQXYOn08aIYc/images/AppleGoogleCalendar.png?fit=max&auto=format&n=yW1NaQXYOn08aIYc&q=85&s=bfa46363e88396b9545d53e1c6d2991f" alt="AppleGoogleCalendar" width="2000" height="1000" data-path="images/AppleGoogleCalendar.png" />
</Frame>

## What you see when you open the app

A personalized welcome area greets you at the top. It knows your name, it knows the time of day, and it adjusts its message accordingly. Morning, afternoon, evening. Not generic placeholder text, but something that feels like opening an app built for you.

Below that, your reminders for the day are listed with the information that matters most: the title, the time, the category color, and whether it's done or still waiting. Nothing extra. No clutter. At a glance, you know exactly what your day looks like.

<Check>Every reminder shows only what you need to act on it. Title, time, category, and status. The detail view is one tap away if you want more.</Check>

## Scrolling that actually feels good

Scroll down and your reminders take center stage. The welcome area moves out of the way smoothly. The day bar stays pinned at the top so you always know which day you're looking at. The screen always feels clean and settled.

## Navigate your week without leaving the screen

A 7-day bar sits below the header. Tap any day to jump straight to that date. Colored dots on each day match your reminder categories, so you can see what types of things are coming up before you even tap. Progress indicators show how much you've completed.

<Note>The dots use your actual category colors. If you change a category color in settings, the dots on the day bar update to match.</Note>

## Built on gestures, not buttons

<Columns cols={3}>
  <Card title="Scroll and snap" icon={<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M12 2.25C12.4142 2.25 12.75 2.58579 12.75 3V7.18934L14.4697 5.46967C14.7626 5.17678 15.2374 5.17678 15.5303 5.46967C15.8232 5.76256 15.8232 6.23744 15.5303 6.53033L12.5303 9.53033C12.2374 9.82322 11.7626 9.82322 11.4697 9.53033L8.46967 6.53033C8.17678 6.23744 8.17678 5.76256 8.46967 5.46967C8.76256 5.17678 9.23744 5.17678 9.53033 5.46967L11.25 7.18934V3C11.25 2.58579 11.5858 2.25 12 2.25ZM12 21.75C11.5858 21.75 11.25 21.4142 11.25 21V16.8107L9.53033 18.5303C9.23744 18.8232 8.76256 18.8232 8.46967 18.5303C8.17678 18.2374 8.17678 17.7626 8.46967 17.4697L11.4697 14.4697C11.7626 14.1768 12.2374 14.1768 12.5303 14.4697L15.5303 17.4697C15.8232 17.7626 15.8232 18.2374 15.5303 18.5303C15.2374 18.8232 14.7626 18.8232 14.4697 18.5303L12.75 16.8107V21C12.75 21.4142 12.4142 21.75 12 21.75ZM4.25 12C4.25 11.5858 4.58579 11.25 5 11.25H19C19.4142 11.25 19.75 11.5858 19.75 12C19.75 12.4142 19.4142 12.75 19 12.75H5C4.58579 12.75 4.25 12.4142 4.25 12Z" fill="currentColor" fillRule="evenodd"/></svg>}>
    Scroll down to focus on your reminders with native haptic feedback at each snap point. The screen settles into a clean layout automatically.
  </Card>

  <Card title="Pull to refresh" icon={<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M2.25 12C2.25 6.61522 6.61521 2.25 12 2.25C15.1908 2.25 18.0209 3.78363 19.799 6.15095L19.8 6.15V3.225C19.8 2.68652 20.2365 2.25 20.775 2.25C21.3135 2.25 21.75 2.68652 21.75 3.225V6.15C21.75 6.81187 21.7524 7.40649 21.6881 7.88481C21.62 8.39116 21.4614 8.91039 21.0359 9.33589C20.6104 9.76139 20.0912 9.92002 19.5848 9.98811C19.1065 10.0524 18.5119 10.05 17.85 10.05H14.925C14.3865 10.05 13.95 9.61348 13.95 9.075C13.95 8.53652 14.3865 8.1 14.925 8.1H17.85C18.2154 8.1 18.5087 8.09857 18.7507 8.09238C17.4002 5.76433 14.8824 4.2 12 4.2C7.69217 4.2 4.2 7.69217 4.2 12C4.2 16.3078 7.69217 19.8 12 19.8C15.3946 19.8 18.285 17.631 19.3563 14.6003C19.5357 14.0926 20.093 13.8267 20.6007 14.0062C21.1082 14.1857 21.3742 14.7421 21.1949 15.2497C19.8569 19.0352 16.2467 21.75 12 21.75C6.61521 21.75 2.25 17.3848 2.25 12Z" fill="currentColor"/></svg>}>
    Pull the screen down to refresh. Release and your reminders reload with fresh data.
  </Card>

  <Card title="Tap a day" icon={<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M17.4424 9.05302C18.0924 9.63724 18.6219 10.1131 18.9916 10.5169C19.3548 10.9135 19.6885 11.3677 19.7401 11.9188C19.7963 12.5179 19.6102 13.1153 19.2226 13.5757C18.8653 14.0001 18.331 14.1808 17.8076 14.2968C17.2746 14.415 16.5697 14.5001 15.7051 14.6046C15.3109 14.6522 15.0279 14.6873 14.8536 14.7257C14.6458 14.7619 14.6396 14.9628 14.6626 15.0587C14.7134 15.2318 14.8042 15.4601 14.9528 15.8306L16.4434 19.5468C16.5222 19.7432 16.5946 19.9237 16.6452 20.0794C16.6996 20.2468 16.7464 20.436 16.745 20.6483C16.7419 21.1113 16.5554 21.555 16.2251 21.8806C16.0735 22.0301 15.9048 22.1282 15.7469 22.2054C15.6002 22.2771 15.4207 22.3501 15.226 22.4293C15.0313 22.5086 14.8116 22.598 14.6566 22.6491C14.4899 22.704 14.3002 22.7517 14.087 22.7503C13.6223 22.7471 13.1793 22.5572 12.856 22.2245C12.7078 22.072 12.6108 21.9026 12.5345 21.7442C12.4635 21.5968 12.3911 21.4163 12.3123 21.22L10.8216 17.5036C10.673 17.1331 10.5808 16.9055 10.4981 16.7454C10.4039 16.5417 10.2204 16.5928 10.1404 16.6438C9.9883 16.7382 9.76049 16.9111 9.44419 17.1526C8.75002 17.6825 8.18442 18.1143 7.71972 18.4022C7.26425 18.6843 6.75455 18.929 6.20237 18.8735C5.60302 18.8132 5.0546 18.512 4.68055 18.0402C4.33692 17.6067 4.2641 17.0467 4.25185 16.5086C4.23935 15.9598 4.292 15.2474 4.35668 14.372L4.92865 6.54146C5.01354 5.26256 5.08522 4.18258 5.28485 3.37109C5.4958 2.51356 5.8954 1.76945 6.76534 1.41543C7.63686 1.06076 8.44077 1.31715 9.18611 1.78778C9.89016 2.23234 10.6871 2.95954 11.6296 3.81962L17.4423 9.05299L17.4424 9.05302Z" fill="currentColor"/></svg>}>
    Tap any day on the navigation bar and your reminder list jumps to that date instantly. No page transitions, no loading screens.
  </Card>
</Columns>

## Context-aware and always current

The welcome area adapts to your day. When you have reminders lined up, it stays compact so your list gets more room. On a clear day, it relaxes and gives the screen a more spacious, playful feel.

Switch to another app and come back? The agenda quietly refreshes in the background. Switch tabs within the app? Same thing. Your agenda stays current without you doing anything.

<Info>Everything updates in real time. Complete a reminder on another device and it disappears from your agenda on this one. Snooze something from a notification and the change shows up here immediately. Native alarms and Live Activity timers show their state right alongside your other reminders.</Info>

## A typical moment

<Steps>
  <Step title="Open the app">
    i greet you with a personalized message based on the time of day. Today's date is already selected on the day bar.
  </Step>

  <Step title="Scan your day">
    Your reminders are listed below with titles, times, and category colors. You know what's ahead in about two seconds.
  </Step>

  <Step title="Scroll for focus">
    Scroll down and the welcome area fades away. Your reminders fill the screen. The day bar stays locked at the top.
  </Step>

  <Step title="Check other days">
    Tap any day on the bar to see what's coming up. Colored dots give you a preview before you even tap.
  </Step>

  <Step title="Pull to refresh">
    Pull down to refresh. Fresh data loads instantly.
  </Step>

  <Step title="Tap for details">
    Tap any reminder to open its full detail view. Edit, snooze, complete, or just check the description. One tap in, one tap out.
  </Step>
</Steps>

## Why this matters

The home screen is where you spend 90% of your time in a reminder app. It should feel as natural as scrolling through your music library. Fluid, responsive, with tactile feedback that tells you exactly where you are.

The goal is to show you the right things at the right time so you can make a decision and move on. No context switching between apps, no mental math to piece together your schedule.

Open the app. Know what to do. Get back to your life.

<Check>The Agenda Explorer exists to simplify your day so you spend less time managing reminders and more time actually doing things.</Check>
