Skip to content

Repository files navigation

task.airat.top

task.airat.top

Smart, local-first task manager with manual task planning and optional AI-assisted tagging/decomposition.

Features

  • Local task storage in the browser (localStorage).
  • First-run demo task with tags, subtasks, priority, and due date.
  • JSON export for all tasks.
  • Created and updated timestamps for tasks.
  • Fast add/complete/delete flow with progress stats and 3-second undo for deletes.
  • Linked completion: completing a task completes its subtasks, and completing all subtasks completes the parent task.
  • Manual task ordering by dragging task titles in manual sort mode.
  • Display sort modes: manual, due date, priority, and updated time.
  • Inline task editing.
  • Task priorities: low, normal, high.
  • Manual due dates with today/overdue status.
  • Filters by task status, due date, and priority.
  • Search by task title, generated tags, and subtask title.
  • Manual tag editing with normalized lowercase kebab-case tags and suggestions from existing tags.
  • Manual subtasks: add, edit, complete, delete, and reorder by dragging subtask text.
  • AI auto-tagging for new and edited tasks (Gemini).
  • AI decomposition into actionable subtasks (Gemini).
  • Literal test tasks are kept local and skipped from AI analysis.
  • Theme switcher (light/dark/system).

Tech Stack

  • React 19
  • TypeScript
  • Vite 6
  • Tailwind CSS 4
  • Gemini API (@google/genai)

Project Structure

  • src/ - application code.
  • public/ - static assets (favicon, robots.txt, site.webmanifest, llms.txt).
  • index.html - app shell and meta tags.
  • vite.config.ts - Vite config.
  • wrangler.jsonc - Cloudflare Worker and static asset configuration.

Local Development

Prerequisites: Node.js 20+ and npm.

  1. Install dependencies:
    npm install
  2. Create local env file and set Gemini key:
    cp .env.example .env.local
  3. Run dev server:
    npm run dev
  4. Open http://localhost:5173.

Build

npm run build
npm run preview

Cloudflare Workers

Use these Workers Builds settings for deployment:

  • Project root: / (repository root)
  • Build command: npm run build
  • Deploy command: npx wrangler deploy
  • Static asset directory: dist (configured in wrangler.jsonc)
  • Build variable: GEMINI_API_KEY
  • Production URL: https://task.airat.top

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

AiratTop

About

Smart, local-first task manager with AI-powered auto-tagging and task decomposition. Built with React, TypeScript, Vite, and Tailwind CSS. Published at https://task.airat.top

Topics

Resources

Code of conduct

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Contributors

Languages