Skip to content

About

Flutter-based app built to simplify and centralize task planning.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

microplanner: a minimalist space for everything you need to do

microplanner is a small planner for Windows and Android. Keep tasks in separate boards, organize them by subject, and see what is upcoming, late or completed. Sign in with Google to keep your work in sync between your computer and phone.

The interface stays simple, with soft colors and small animations. Each Google account has its own workspace. When you are offline, you can still read the last saved copy; editing resumes when you reconnect.

Install

Android

Download Android APK (0.13.0)

Release notes

  1. Open GitHub Releases and choose the newest version with an APK attached. Versions before 1.0 are published as prereleases.
  2. Download microplanner-<version>-android.apk and open it on your phone. If Android asks, allow your browser or file manager to install this APK.
  3. Open microplanner and sign in with Google. No USB connection is needed.

To update, install the newer APK over the existing app. Keep the existing app installed so its local data and session remain available. The adjacent .apk.sha256 file lets you verify the download if needed.

Windows

A ready-to-download Windows bundle is not published yet. You can build the app from source with Git and Flutter 3.38.6, including its Windows desktop build tools:

git clone https://github.com/macorisd/microplanner.git
cd microplanner
flutter pub get
flutter build windows --release

Open build/windows/x64/runner/Release/microplanner.exe and sign in with Google. You can copy the complete Release folder to another location and create a shortcut there; keep the executable, DLLs and data folder together. To update, close the app before replacing that complete bundle.

Both platforms use the hosted service by default. Google sign-in availability follows the current OAuth project's access settings.

Task reminders

Open Profile > Settings > Notifications and enable reminders on each device you want to notify you. The account default is 24 hours before a deadline, with an optional second reminder at the deadline. Each task can inherit that default, use a custom advance time or disable reminders. Quiet hours and hiding task details apply only to the current account on this device. Sound, vibration and Do Not Disturb follow system settings; use Send test notification to check setup.

Android asks for notification permission and guides you to Alarms & reminders access for alerts at the selected time. Without precise access, Android can delay an alarm by up to an hour, or longer under battery restrictions; a short deadline can pass before delivery. Removing the app from recents does not require it to stay running. Force stop still prevents alarms until the app is opened again. Windows registers microplanner in the Start Menu for notification activation and keeps the same normal executable/bundle.

Reminders are scheduled locally and can run with the app closed. Background sync, enabled with device notifications, checks cloud task changes about every 30 minutes and cancels or updates reminders without opening the app. Android requires a connection and avoids checks with low battery; Windows uses a brief per-user scheduled task, including after sign-in, without waking the computer or leaving a process running. Switch it off independently in Notifications, where you can see the last successful reminder sync. Checks never submit pending edits.

Changes on another device take effect after the next successful check; the system may delay it, and offline devices can still show outdated reminders. Power-off, Android Force stop/battery restrictions, denied permissions and OS delivery limits can prevent a reminder. Reopen microplanner to refresh tasks and scheduling coverage. The nearest 200 events are scheduled within the current sign-in session; the settings page reports partial coverage. No repeated overdue alerts are sent. Quiet hours never defer a reminder past its task's deadline. After changing the device clock or time zone, reopen microplanner so quiet hours and future reminder times are recalculated in the new local time zone.

Version history

The table describes changes when each version was introduced. Features may have been refined by later versions. The unreleased row is available from source; Android downloads appear in Releases after publication.

Version Changes
0.13.0 Permanently delete your microplanner account from Settings > Account.
0.12.0
  • Receive Android and Windows task deadline reminders, with timing, quiet hours, privacy and device controls in Settings > Notifications.
  • Keep reminders up to date with lightweight background sync on Android and Windows.
0.11.8
  • Use the microplanner app artwork and README tagline on the sign-in screen.
0.11.7
  • Align the Windows completion checkbox hover feedback with the checkbox itself.
  • Reveal a newly created task with a fast scroll toward the center of its column, respecting scroll limits on Windows and Android.
0.11.6
  • Use compact task-card spacing on Windows while preserving Android's layout.
  • Show only one completion checkbox on each task card.
0.11.5
  • Keep the selected task type visible while a newly created task is synchronizing.
  • Use the Board's configured Subject order in Create Task and Edit Task.
  • Prevent another sidebar board reorder until the previous reorder finishes synchronizing.
0.11.4
  • Standardize rounded form actions with balanced fixed footers on Windows and Android, including small screens and keyboards.
  • Use consistent Create, Save changes and Delete labels, including Delete Completed tasks.
  • Keep Cancel compact and aligned with the proceed action, with equal visible bottom and right margins throughout forms and date/time pickers.
  • Use consistent footer margins throughout Windows and Android forms, with Android matching Edit Board.
  • Reduce icon-picker footer spacing and give default-list selection a right-aligned Cancel button.
  • Remove excessive blank space before form actions, including task editors and manual date/time entry; keep validation stable.
  • Remove in-app sign-in cancellation and retain retry after failure.
  • Apply the same action conventions to saved drafts, confirmations and limit messages.
  • Keep dropped boards in their new order throughout synchronization.
  • Disable sidebar board reordering while board changes are syncing.
0.11.3
  • Place Task type after Subject and before Deadline in task creation and editing forms.
  • Focus Name in creation forms and show required-name feedback after leaving or clearing the field.
  • Prevent duplicate board, subject and task type names.
  • Keep subject spacing compact and square task type icons aligned beside names at matching heights on Android.
  • Keep Edit Board actions centered in a compact fixed footer.
  • Use smaller, aligned remove icons in subject and task type lists.
  • Center the original pastel Windows board icon button in a passive gray panel aligned with the color palette.
  • Animate sidebar Boards expansion and collapse.
  • Show a soft travelling edge light during board saves, tracing the same card perimeter on Windows and Android; pending edit/delete clicks do nothing while names still open boards.
  • Enlarge category reorder handles; on Android drag handles immediately and hold names to reorder, without edit tooltips.
0.11.2
  • Use consistent rounded selector arrows, including the time field on Android.
  • Align the Boards and Weekly Plan navigation icons.
  • Open Edit Board from the board title and reveal its delete action on hover or keyboard focus.
  • Keep New Board and Edit Board compact with tighter spacing and stable validation.
0.11.1
  • Use Enter to save enabled forms throughout the app.
  • Accept a date by choosing its day and a time by choosing its minutes, without OK, with visible clock needle movement.
  • Keep forms steady when validation or save errors appear, with aligned category and picker controls.
  • Use a wider date range with automatic separators and validation after the complete year.
  • Keep Android in portrait orientation.
0.11.0
  • Navigate with a refreshed sidebar and a Weekly Plan preview.
  • Customize board icons, 21 shared colors in rainbow order, subjects and task types, with matching board titles on a neutral canvas.
  • Manage reusable task type lists in Settings.
  • View your account and sign out from Profile.
  • Keep account and customization views consistent with task forms, including Back navigation, focus and save safeguards.
  • Keep dragged rows inside their lists and sidebar rows steady on hover, with colored labels, pale backgrounds and direct Android board actions.
0.10.3
  • Save from the expanded description with Ctrl+Enter.
  • Keep description scrollbars clear of text.
  • Confirm date and time with Enter, and show Cancel in red in the time picker.
  • Show task creation, deletion and same-column edits while they synchronize.
0.10.2
  • Hold the destination color for 1.5 seconds, then fade it out over one second.
  • Use a black completion strike at the source and keep its destination appearance consistent through the end of the animation.
  • Allow task actions immediately on arrival, with smooth chained moves and deletion.
  • Count the minimum 2.5-second creation/deletion animation from the original action, awaiting cloud confirmation when needed.
  • Refresh the banner tagline to describe a minimalist space.
0.10.1
  • Update README download and version links automatically after verified Android publication.
0.10.0
  • Edit Windows tasks by clicking their cards.
  • Expand descriptions in matching dialogs with the task title and Back navigation.
  • Save with Enter after date/time selection; limit board names to 50 characters.
  • Refresh the project guide and release history.
0.9.0
  • Save actions in the background and recover pending work after reopening.
  • Animate task moves and deletion, with confirmed synchronization and rollback on failure.
0.8.0
  • Let Android apply its own launcher icon shape.
  • Use Completed consistently; reveal the Windows clear action on hover.
  • Save descriptions with Ctrl+Enter on Windows and open editing without selecting text.
0.7.0
  • Synchronize behind an icon-only startup screen.
  • Remember the last column of each Android board and zoom into its logo color.
  • Use the animated logo in cloud progress notices.
0.6.0
  • Remember the last board per account and device.
  • Clear completed tasks from the current board with confirmation.
  • Improve priority spacing and prevent unwanted keyboard reopening.
0.5.2
  • Prevent repeated submissions and disable saving unchanged forms.
  • Validate text lengths and edge cases throughout the app.
  • Keep Windows completion hover feedback compact.
0.5.1
  • Show subject colors in task forms.
  • Keep accepted button actions from being lost during synchronization.
0.5.0
  • Navigate Android columns using a layered carousel and three-icon selector.
  • Open the sidebar with a left-edge drag and edit tasks by tapping them.
  • Remove the redundant refresh spinner.
0.4.0
  • Set the Windows minimum size to half the monitor dimensions.
  • Keep Android column colors visible when empty.
  • Refine Material 3 styling, responsive layouts and rendering; fix sidebar hover trails.
0.3.0
  • Show cloud progress in a floating card without moving content.
  • Add coordinated interface animations and reduced-motion support.
0.2.7
  • Show the Google profile photo in the sidebar.
0.2.6
  • Compact Android task controls and match system bars to the app background.
0.2.5
  • Tighten Android layouts and fit subject badges to their text.
0.2.4
  • Make Android task and sidebar controls usable without hover.
0.2.3
  • Fix recovery and verification of draft APK releases.
0.2.2
  • Support the Android SDK 37 certificate verification output.
0.2.1
  • Verify APK certificates independently of signer labels.
0.2.0
  • Host the cloud API on Vercel.
  • Publish signed Android APKs as GitHub prereleases.
  • Use the app artwork for the Android icon.
0.1.0
  • Sign in with Google on Windows and Android.
  • Store private per-account data in MongoDB and import existing local data with confirmation.
  • Read the last saved copy while offline.
0.0.1 (initial)
  • Create local boards, subjects and tasks with deadlines and priorities.
Run your own microplanner: developer setup

Use Flutter 3.38.6 / Dart 3.10.7, Node.js 24, a MongoDB replica set (Atlas works), and a Google OAuth project with Desktop, Web and Android clients.

  1. Copy server.env.example to the ignored server.env and configure MongoDB and your Google credentials. Keep server secrets out of the app and Git.

  2. In server/, run npm ci and npm run dev.

  3. From the repository root, run flutter pub get, then:

    flutter run -d windows --dart-define=API_BASE_URL=http://127.0.0.1:3000

Override the public OAuth IDs for your project. For Android, register com.microplanner.microplanner with your build certificate's SHA-1 and use --dart-define=GOOGLE_WEB_CLIENT_ID=.... The Windows ID also has a GOOGLE_WINDOWS_CLIENT_ID Dart define. Set the matching IDs on the API.

For an Android emulator, the local API address is http://10.0.2.2:3000. For a physical device over USB, use adb reverse tcp:3000 tcp:3000 and http://127.0.0.1:3000 with a debug build. Release APKs require HTTPS and a persistent signing key.

Run flutter analyze and flutter test; in server/, run npm run build and npm test. See development setup for local connection and authentication details, and hosting and releases for Vercel deployment, signing and APK publication.

About

Flutter-based app built to simplify and centralize task planning.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages