polar. documentation

overview

polar. is an offline-first android task manager built with kotlin. it follows clean architecture + mvvm and stores everything locally using room.

the app targets android 7.0+ (api 24) and is compiled with the latest android sdk. it intentionally does not request the internet permission.

key features

• ✓ tasks with title, description, due date, priority, estimated time and recurrence
• ✓ unlimited subtasks with checkbox completion
• ✓ custom lists with icon, color and drag & drop ordering
• ✓ tag-based filtering with #tag syntax
• ✓ monthly calendar with dot indicators and daily agenda
• ✓ date, time and location-based reminders
• ✓ statistics with bar, line and donut charts
• ✓ 7 themes, 6 fonts, 2 checkbox styles and font size slider
• ✓ launcher widget for today's tasks
• ✓ local backup and restore in json, plus csv import

architecture

the app uses a single activity with manual fragmentmanager navigation. ui is built with xml layouts and view binding.

dependency injection is handled by hilt. background work uses kotlin coroutines and workmanager for recurring tasks.

core stack

permissions

polar. does not declare the internet permission. it only requests the minimum permissions required for alarms, notifications and optional location reminders.

backup & restore

you can export your entire database to a json file from settings. the file can be imported later on the same or a new device.

csv import is also supported for migrating simple task lists from spreadsheets.

frequently asked questions