Skip to content

fajarwz/wordventure-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“š Wordventure Bot β€” Your Daily Dose of Words, via Telegram

Wordventure Bot is a Node.js-powered Telegram bot that sends subscribers a new English word every day β€” complete with definitions, examples, synonyms, and antonyms β€” to help grow your vocabulary effortlessly.

✨ Features

πŸ’¬ Sends beautifully formatted daily word messages on Telegram
πŸ“– Provides multiple definitions, usage examples, synonyms, and antonyms
πŸ” Retries fetching words if data is incomplete or unavailable
πŸ”” Scheduled delivery via cron (daily at 9 AM or customizable)
🧠 Words are randomly selected to keep it fresh
πŸ“¦ Uses Prisma and PostgreSQL to manage subscribers

βš™οΈ Tech Stack

  • Node.js
  • Prisma + PostgreSQL
  • Telegram Bot API
  • Axios
  • node-cron

πŸ›  Setup

# Clone the project
git clone https://github.com/yourusername/wordventure-bot.git
cd wordventure-bot

# Install dependencies
npm install

# Set your environment variables
cp .env.example .env
# Edit .env to include your Telegram bot token and database URL

# Generate Prisma client
npx prisma generate

# Run the bot
npm start

πŸ’‘ Inspiration

Inspired by the idea of learning a little every day. Whether you're a word nerd, student, or language learner, this bot helps you stay curious and consistent.

Data Source

About

Your Daily Dose of Words, via Telegram

Resources

Stars

Watchers

Forks