Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/celestial-0/taskly

๐Ÿค– AI-powered task management app built with React Native. Capture tasks via text, voice, or images with smart auto-categorization. Local-first with optional cloud sync.
https://github.com/celestial-0/taskly

drizzle-orm expo mobile-app nativewind react-native sqlite task-tracker typescript

Last synced: 4 months ago
JSON representation

๐Ÿค– AI-powered task management app built with React Native. Capture tasks via text, voice, or images with smart auto-categorization. Local-first with optional cloud sync.

Awesome Lists containing this project

README 

          


  Taskly Logo

  Taskly Documentation




## ๐Ÿ†• What's New in v1.1.2



* ๏ฟฝ **Task Detail Screen** โ€“ Comprehensive task view with progress, subtasks, time tracking, and meta info

* โœ๏ธ **Markdown Preview** โ€“ Rich text formatting in task descriptions with live preview toggle

* โœ… **Enhanced Subtasks** โ€“ Improved subtask management with better UX and error handling

* โฑ๏ธ **Time Tracking** โ€“ Built-in time tracker with session history and total time display

* ๏ฟฝ **UI Improvements** โ€“ Better progress bars, category badges, and visual feedback

* ๐Ÿ› **Bug Fixes** โ€“ Corrected completion percentage logic and progress bar styling

* ๐Ÿ“ฆ **Dependencies** โ€“ Added date-fns for better date formatting and manipulation



See the [CHANGELOG.md](CHANGELOG.md) for full details.



---



## ๐Ÿ“Œ Overview



**Taskly** is an **open-source, AI-powered task management app** built with **React Native** and **Expo**.

It helps you **capture, organize, and manage tasks** with AI-powered categorization and a modern, offline-first approach.



Designed to be **local-first**, **extensible**, and **community-driven**, Taskly is the productivity companion for **students, developers, and teams** who value simplicity, speed, and data portability.



**Current Version:** `1.1.2` (Latest Release)



---



## โœจ Features



### ๐ŸŽฏ Core Features

* ๐Ÿ“ **Task Management** โ€“ Create, update, complete, and delete tasks

* ๐Ÿ“‹ **Task Details** โ€“ Comprehensive view with progress, subtasks, time tracking, and metadata (v1.1.2)

* โœ๏ธ **Markdown Support** โ€“ Rich text formatting in task descriptions with live preview (v1.1.2)

* โฑ๏ธ **Time Tracking** โ€“ Built-in timer with session history and total time tracking (v1.1.2)

* ๐ŸŽฏ **Swipe Gestures** โ€“ Swipe-to-delete with haptic feedback (v1.0.2)

* ๐Ÿ’พ **Offline-First Storage** โ€“ Expo SQLite + Drizzle ORM with AsyncStorage fallback

* ๐Ÿค– **AI-Powered Categorization** โ€“ Auto-categorize tasks (Work, Study, Personal, etc.)

* ๐Ÿ“ค๐Ÿ“ฅ **Import/Export** โ€“ Backup and restore tasks in JSON/CSV format

* ๐ŸŒ™ **Modern UI/UX** โ€“ Clean interface with dark mode and smooth animations

* ๐Ÿ“ณ **Haptic Feedback** โ€“ Tactile feedback for improved user experience (v1.0.2)

* โš™๏ธ **Modular Settings** โ€“ Organized Settings screen with About, AI, Notifications, and Export/Import sections (v1.1.0)

* ๐ŸŽจ **Component Architecture** โ€“ Feature-based organization for better maintainability (v1.1.0)

* ๐Ÿ“ฑ **Cross-Platform** โ€“ iOS, Android, and Web support via Expo



### ๐Ÿš€ Coming Soon

* ๐Ÿ“ธ **OCR Input** โ€“ Scan handwritten notes and convert to tasks

* ๐ŸŽ™๏ธ **Voice Input** โ€“ Create tasks via speech-to-text

* ๐Ÿ”„ **Cloud Sync** โ€“ Multi-device synchronization with Supabase

* ๐Ÿ”Œ **Plugin System** โ€“ Community-driven extensions



---



## ๐Ÿ› ๏ธ Tech Stack



* **Frontend:** [React Native](https://reactnative.dev/) + [Expo Router](https://docs.expo.dev/router/)

* **Styling:** [Nativewind](https://www.nativewind.dev/) + [RN Primitives](https://rn-primitives.vercel.app/)

* **Database:** [Expo SQLite](https://docs.expo.dev/versions/latest/sdk/sqlite/) + [Drizzle ORM](https://orm.drizzle.team/)

* **State Management:** [Zustand](https://zustand-demo.pmnd.rs/)

* **Cloud Sync (optional):** [Supabase](https://supabase.com/)

* **AI:** [OpenAI API](https://platform.openai.com/) (categorization & summarization)



---



## ๐Ÿ“‚ Folder Structure



```

taskly/

โ”œโ”€โ”€ app/             # Expo Router pages & main entry point

โ”œโ”€โ”€ components/      # Reusable UI components

โ”‚   โ”œโ”€โ”€ core/        # Core app components (Screens & Layouts)

โ”‚   โ””โ”€โ”€ ui/          # UI primitives (from @rn-primitives)

โ”œโ”€โ”€ services/        # API, AI, OCR, and database logic

โ”œโ”€โ”€ models/          # Database schemas (Drizzle ORM)

โ”œโ”€โ”€ lib/             # Utilities and helper functions

โ”œโ”€โ”€ assets/          # Images, icons, fonts

โ”œโ”€โ”€ db/              # Database migrations and setup

โ”œโ”€โ”€ package.json

โ””โ”€โ”€ README.md

```



---



## ๐Ÿš€ Getting Started



### 1. Clone the Repository



```bash

git clone https://github.com/Celestial-0/taskly.git

cd taskly

```



### 2. Navigate to Project Directory



```bash

cd taskly

```



### 3. Install Dependencies



```bash

npm install

```



### 4. Environment Setup



Create a `.env` file in the `taskly/` directory:



```bash

OPENAI_API_KEY=your_openai_api_key

SUPABASE_URL=your_supabase_url (optional)

SUPABASE_KEY=your_supabase_key (optional)

```



### 5. Run the App



```bash

# Development server

npm run dev



# Android

npm run android



# iOS

npm run ios



# Web

npm run web

```



---



## ๐Ÿ“… Roadmap



Taskly will evolve step by step โ€” starting small, then expanding into a powerful open-source productivity ecosystem.



---



This looks really solid already ๐Ÿ”ฅ

Iโ€™d recommend a few **enhancements for README polish** so contributors and users instantly โ€œget itโ€:



---



## ๐Ÿ“… Roadmap



Taskly will evolve step by step โ€” starting small, then expanding into a powerful open-source productivity ecosystem.



---



### โœ… MVP (Foundations)



Focus on **simplicity and offline-first usability**:



* โœ๏ธ **Core task management (CRUD)** โ†’ Create, update, complete, delete tasks

* ๐Ÿ’พ **Offline-first local storage** with **Expo SQLite + Drizzle ORM** and **AsyncStorage**

* ๐Ÿค– **Basic AI categorization** โ†’ Auto-tag tasks (Work, Study, Personal, etc.)

* ๐Ÿ“ค๐Ÿ“ฅ **Import/Export tasks** โ†’ JSON/CSV for backup & portability



๐Ÿ“Œ **Goal:** A lightweight, offline-first task manager that feels fast and reliable.



---



### ๐Ÿš€ Phase 2 (Smarter Inputs & Extensibility)



Expand beyond manual input with **AI-first task capture**:



* ๐Ÿ“ธ **OCR input** โ†’ Scan handwritten/digital notes โ†’ auto-generate tasks

* ๐ŸŽ™๏ธ **Voice input** โ†’ Create tasks via speech-to-text

* โœจ **Enhanced AI summarization** โ†’ Turn raw notes into structured tasks

* ๐Ÿ”Œ **Plugin system (v1)** โ†’ Allow developers to extend Taskly with mini-plugins



๐Ÿ“Œ **Goal:** Reduce friction in capturing tasks, and open the door for community contributions.



---



### ๐ŸŒ Phase 3 (Collaboration & Integrations)



Transform Taskly into a **connected, multi-device, team-friendly tool**:



* ๐Ÿ”„ **Multi-device sync** โ†’ Supabase (Postgres + Realtime) backend

* ๐Ÿ”— **Integrations** โ†’ GitHub Issues, Notion pages, Obsidian notes

* ๐Ÿ‘ฅ **Team collaboration** โ†’ Shared task lists, permissions, real-time updates

* ๐Ÿ† **Gamification** โ†’ Streaks, badges, and progress insights for motivation



๐Ÿ“Œ **Goal:** Move from personal productivity โ†’ team productivity.



---



### ๐Ÿ”ฎ Phase 4 (AI Productivity Ecosystem)



Long-term vision: Taskly as an **AI-powered open productivity hub**:



* ๐Ÿง‘โ€๐Ÿ’ป **AI assistant** โ†’ Personalized study/work planner with adaptive reminders

* ๐Ÿ“š **Knowledge extraction** โ†’ Auto-extract insights from notes, PDFs, slides

* ๐ŸŒ **Cross-platform companions** โ†’ Chrome extension + Gmail add-on

* ๐Ÿ› ๏ธ **Community plugin marketplace** โ†’ Share & discover Taskly plugins



๐Ÿ“Œ **Goal:** Build a thriving **open-source ecosystem** around productivity.



---



โšก **Note:** This roadmap is **community-driven** โ€” features may shift as contributors propose ideas and users share feedback.



---



## ๐Ÿงช Testing & Development



```bash

# Type checking

npx tsc --noEmit



# Code formatting

npx prettier --check .

npx prettier --write .



# Clean build

npm run clean

```



---



## ๐Ÿค Contributing



We โค๏ธ contributions!



* Open an issue for bugs or feature requests.

* Fork the repo and submit a PR.

* Follow our [CONTRIBUTING.md](CONTRIBUTING.md) guide.



---



## ๐Ÿ“œ License



**MIT License** โ€“ free to use, modify, and share.



---