{"id":31581253,"url":"https://github.com/celestial-0/taskly","last_synced_at":"2025-10-23T17:01:56.403Z","repository":{"id":317870280,"uuid":"1069009997","full_name":"Celestial-0/Taskly","owner":"Celestial-0","description":"🤖 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.","archived":false,"fork":false,"pushed_at":"2025-10-03T16:08:42.000Z","size":435,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-03T16:17:26.602Z","etag":null,"topics":["drizzle-orm","expo","mobile-app","nativewind","react-native","sqlite","task-tracker","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Celestial-0.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-03T09:03:00.000Z","updated_at":"2025-10-03T16:08:46.000Z","dependencies_parsed_at":"2025-10-03T16:18:02.169Z","dependency_job_id":"2074e3a1-4193-490b-8bf0-3bd1e33aab63","html_url":"https://github.com/Celestial-0/Taskly","commit_stats":null,"previous_names":["celestial-0/taskly"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Celestial-0/Taskly","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Celestial-0%2FTaskly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Celestial-0%2FTaskly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Celestial-0%2FTaskly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Celestial-0%2FTaskly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Celestial-0","download_url":"https://codeload.github.com/Celestial-0/Taskly/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Celestial-0%2FTaskly/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278526244,"owners_count":26001326,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["drizzle-orm","expo","mobile-app","nativewind","react-native","sqlite","task-tracker","typescript"],"created_at":"2025-10-05T21:55:26.073Z","updated_at":"2025-10-23T17:01:56.397Z","avatar_url":"https://github.com/Celestial-0.png","language":"TypeScript","readme":"\u003cdiv style=\"display: flex; align-items: center; justify-content: center;\"\u003e\n  \u003cimg src=\"https://github.com/Celestial-0/Taskly/blob/main/mobile/assets/images/favicon.png?raw=true\" alt=\"Taskly Logo\" width=\"30\" height=\"30\" style=\"margin-right: 8px;\"\u003e\n  \u003cspan style=\"font-weight: bold; font-size: 20px;\"\u003eTaskly Documentation\u003c/span\u003e\n\u003c/div\u003e\n\n## 🆕 What's New in v1.1.2\n\n* � **Task Detail Screen** – Comprehensive task view with progress, subtasks, time tracking, and meta info\n* ✍️ **Markdown Preview** – Rich text formatting in task descriptions with live preview toggle\n* ✅ **Enhanced Subtasks** – Improved subtask management with better UX and error handling\n* ⏱️ **Time Tracking** – Built-in time tracker with session history and total time display\n* � **UI Improvements** – Better progress bars, category badges, and visual feedback\n* 🐛 **Bug Fixes** – Corrected completion percentage logic and progress bar styling\n* 📦 **Dependencies** – Added date-fns for better date formatting and manipulation\n\nSee the [CHANGELOG.md](CHANGELOG.md) for full details.\n\n---\n\n## 📌 Overview\n\n**Taskly** is an **open-source, AI-powered task management app** built with **React Native** and **Expo**.\nIt helps you **capture, organize, and manage tasks** with AI-powered categorization and a modern, offline-first approach.\n\nDesigned 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.\n\n**Current Version:** `1.1.2` (Latest Release)\n\n---\n\n## ✨ Features\n\n### 🎯 Core Features\n* 📝 **Task Management** – Create, update, complete, and delete tasks\n* 📋 **Task Details** – Comprehensive view with progress, subtasks, time tracking, and metadata (v1.1.2)\n* ✍️ **Markdown Support** – Rich text formatting in task descriptions with live preview (v1.1.2)\n* ⏱️ **Time Tracking** – Built-in timer with session history and total time tracking (v1.1.2)\n* 🎯 **Swipe Gestures** – Swipe-to-delete with haptic feedback (v1.0.2)\n* 💾 **Offline-First Storage** – Expo SQLite + Drizzle ORM with AsyncStorage fallback\n* 🤖 **AI-Powered Categorization** – Auto-categorize tasks (Work, Study, Personal, etc.)\n* 📤📥 **Import/Export** – Backup and restore tasks in JSON/CSV format\n* 🌙 **Modern UI/UX** – Clean interface with dark mode and smooth animations\n* 📳 **Haptic Feedback** – Tactile feedback for improved user experience (v1.0.2)\n* ⚙️ **Modular Settings** – Organized Settings screen with About, AI, Notifications, and Export/Import sections (v1.1.0)\n* 🎨 **Component Architecture** – Feature-based organization for better maintainability (v1.1.0)\n* 📱 **Cross-Platform** – iOS, Android, and Web support via Expo\n\n### 🚀 Coming Soon\n* 📸 **OCR Input** – Scan handwritten notes and convert to tasks\n* 🎙️ **Voice Input** – Create tasks via speech-to-text\n* 🔄 **Cloud Sync** – Multi-device synchronization with Supabase\n* 🔌 **Plugin System** – Community-driven extensions\n\n---\n\n## 🛠️ Tech Stack\n\n* **Frontend:** [React Native](https://reactnative.dev/) + [Expo Router](https://docs.expo.dev/router/)\n* **Styling:** [Nativewind](https://www.nativewind.dev/) + [RN Primitives](https://rn-primitives.vercel.app/)\n* **Database:** [Expo SQLite](https://docs.expo.dev/versions/latest/sdk/sqlite/) + [Drizzle ORM](https://orm.drizzle.team/)\n* **State Management:** [Zustand](https://zustand-demo.pmnd.rs/)\n* **Cloud Sync (optional):** [Supabase](https://supabase.com/)\n* **AI:** [OpenAI API](https://platform.openai.com/) (categorization \u0026 summarization)\n\n---\n\n## 📂 Folder Structure\n\n```\ntaskly/\n├── app/             # Expo Router pages \u0026 main entry point\n├── components/      # Reusable UI components\n│   ├── core/        # Core app components (Screens \u0026 Layouts)\n│   └── ui/          # UI primitives (from @rn-primitives)\n├── services/        # API, AI, OCR, and database logic\n├── models/          # Database schemas (Drizzle ORM)\n├── lib/             # Utilities and helper functions\n├── assets/          # Images, icons, fonts\n├── db/              # Database migrations and setup\n├── package.json\n└── README.md\n```\n\n---\n\n## 🚀 Getting Started\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/Celestial-0/taskly.git\ncd taskly\n```\n\n### 2. Navigate to Project Directory\n\n```bash\ncd taskly\n```\n\n### 3. Install Dependencies\n\n```bash\nnpm install\n```\n\n### 4. Environment Setup\n\nCreate a `.env` file in the `taskly/` directory:\n\n```bash\nOPENAI_API_KEY=your_openai_api_key\nSUPABASE_URL=your_supabase_url (optional)\nSUPABASE_KEY=your_supabase_key (optional)\n```\n\n### 5. Run the App\n\n```bash\n# Development server\nnpm run dev\n\n# Android\nnpm run android\n\n# iOS\nnpm run ios\n\n# Web\nnpm run web\n```\n\n---\n\n\n## 📅 Roadmap\n\nTaskly will evolve step by step — starting small, then expanding into a powerful open-source productivity ecosystem.\n\n---\n\nThis looks really solid already 🔥\nI’d recommend a few **enhancements for README polish** so contributors and users instantly “get it”:\n\n---\n\n## 📅 Roadmap\n\nTaskly will evolve step by step — starting small, then expanding into a powerful open-source productivity ecosystem.\n\n---\n\n### ✅ MVP (Foundations)\n\nFocus on **simplicity and offline-first usability**:\n\n* ✏️ **Core task management (CRUD)** → Create, update, complete, delete tasks\n* 💾 **Offline-first local storage** with **Expo SQLite + Drizzle ORM** and **AsyncStorage**\n* 🤖 **Basic AI categorization** → Auto-tag tasks (Work, Study, Personal, etc.)\n* 📤📥 **Import/Export tasks** → JSON/CSV for backup \u0026 portability\n\n📌 **Goal:** A lightweight, offline-first task manager that feels fast and reliable.\n\n---\n\n### 🚀 Phase 2 (Smarter Inputs \u0026 Extensibility)\n\nExpand beyond manual input with **AI-first task capture**:\n\n* 📸 **OCR input** → Scan handwritten/digital notes → auto-generate tasks\n* 🎙️ **Voice input** → Create tasks via speech-to-text\n* ✨ **Enhanced AI summarization** → Turn raw notes into structured tasks\n* 🔌 **Plugin system (v1)** → Allow developers to extend Taskly with mini-plugins\n\n📌 **Goal:** Reduce friction in capturing tasks, and open the door for community contributions.\n\n---\n\n### 🌍 Phase 3 (Collaboration \u0026 Integrations)\n\nTransform Taskly into a **connected, multi-device, team-friendly tool**:\n\n* 🔄 **Multi-device sync** → Supabase (Postgres + Realtime) backend\n* 🔗 **Integrations** → GitHub Issues, Notion pages, Obsidian notes\n* 👥 **Team collaboration** → Shared task lists, permissions, real-time updates\n* 🏆 **Gamification** → Streaks, badges, and progress insights for motivation\n\n📌 **Goal:** Move from personal productivity → team productivity.\n\n---\n\n### 🔮 Phase 4 (AI Productivity Ecosystem)\n\nLong-term vision: Taskly as an **AI-powered open productivity hub**:\n\n* 🧑‍💻 **AI assistant** → Personalized study/work planner with adaptive reminders\n* 📚 **Knowledge extraction** → Auto-extract insights from notes, PDFs, slides\n* 🌐 **Cross-platform companions** → Chrome extension + Gmail add-on\n* 🛠️ **Community plugin marketplace** → Share \u0026 discover Taskly plugins\n\n📌 **Goal:** Build a thriving **open-source ecosystem** around productivity.\n\n---\n\n⚡ **Note:** This roadmap is **community-driven** — features may shift as contributors propose ideas and users share feedback.\n\n---\n\n## 🧪 Testing \u0026 Development\n\n```bash\n# Type checking\nnpx tsc --noEmit\n\n# Code formatting\nnpx prettier --check .\nnpx prettier --write .\n\n# Clean build\nnpm run clean\n```\n\n---\n\n## 🤝 Contributing\n\nWe ❤️ contributions!\n\n* Open an issue for bugs or feature requests.\n* Fork the repo and submit a PR.\n* Follow our [CONTRIBUTING.md](CONTRIBUTING.md) guide.\n\n---\n\n## 📜 License\n\n**MIT License** – free to use, modify, and share.\n\n---\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcelestial-0%2Ftaskly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcelestial-0%2Ftaskly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcelestial-0%2Ftaskly/lists"}