Taskly Bot 🤖

A Telegram bot built with NestJS to help you manage tasks, track focus time, and receive smart reminders.

---

🚀 Overview

Taskly Bot is a productivity-focused Telegram bot that helps users:

• Manage daily tasks
• Track working sessions
• Receive focus / break / half-time notifications
• View daily activity reports
• Control reminders through user settings

The bot is built with a modular NestJS structure and uses config-driven scheduling for time-based notifications.

---

✨ Features

📝 Task Management

• Add, edit, and delete tasks
• Start and end task sessions
• Prevent multiple active tasks at the same time
• Friendly inline/clickable buttons for all interactions

⏱ Time Tracking

• Track working sessions per task
• Automatically calculate duration
• Automatically force‑closes sessions at the end of the day

📊 Reports

• Daily task report
• Session breakdown per task
• Total working time per day

🔔 Smart Notifications

• Daily reminders
• Focus / Break / Half-time alerts (configurable)
• User-controlled settings (on/off)

⚙️ User Settings

• Enable / disable reminders
• Enable / disable focus alerts
• Set preferred language (Persian 🇮🇷 or English 🇬🇧)
• Language changes reflected instantly thanks to internal caching
• Designed for future extensibility

🌐 Multilingual Support

• Full Persian & English translations
• Automatic loading + caching of user language
• New default behavior:
  • Existing users default to Persian
  • New users default to English

---

🧠 Focus & Time Blocks

Taskly supports automatic time-block notifications such as:

• 🎯 Focus Time
• ☕ Break Time
• 🍽️ Half Time

Defined using a JSON configuration file and scheduled automatically.

Example:

[
  {
    "type": "Focus",
    "startTime": "08:00:00",
    "endTime": "09:00:00"
  },
  {
    "type": "Break",
    "startTime": "09:00:00",
    "endTime": "09:15:00"
  }
]

🛠 Tech Stack

• NestJS
• Telegram Bot API
• Prisma ORM
• PostgreSQL
• node-cron
• TypeScript

---

🧪 Installation & Setup

1️⃣ Clone the repository

git clone https://github.com/Sepehr-Aghdasi/taskly-bot.git
cd taskly-bot

2️⃣ Install dependencies

npm install

3️⃣ Environment variables

Create a .env file:

DATABASE_URL=postgresql://user:password@localhost:5432/taskly
TELEGRAM_TOKEN=your_telegram_bot_token

4️⃣ Database setup

npx prisma generate
npx prisma migrate dev --name init

Optional: GUI to view database content

npx prisma studio

---

▶️ Running the Bot

npm run start:dev

Production

npm run build
npm run start:prod

---

🤖 Bot Behavior

• /start initializes the user
• Button-based interactions for:
  • Task creation
  • Task list
  • Daily report
  • Settings
• All interactions are handled through inline keyboard buttons

---

📎 Project Links

• LinkedIn Post about Taskly Bot
• Telegram Id

---

🤝 Contributing

Pull requests are welcome. Please keep commits clean and focused.

Built with ❤️ using NestJS