Bot starter template based on grammY bot framework.

• Scalable structure
• Config loading and validation
• Internationalization, language changing
• Graceful shutdown
• Logger (powered by pino)
• Fast and low overhead server (powered by fastify)
• Ready-to-use deployment setups:
  • Docker
  • Vercel
• Examples:
  • Prisma ORM
  • grammY plugins:
    • Conversations
    • Runner
  • Web Apps:
    • Vanilla (No frameworks)
    • Vue

Follow these steps to set up and run your bot using this template:

1. Create a New Repository

   Start by creating a new repository using this template. You can do this by clicking here.

2. Environment Variables Setup

   Create an environment variables file by copying the provided example file:

   cp .env.example .env

   Open the newly created .env file and set the BOT_TOKEN environment variable.

3. Launching the Bot

   You can run your bot in both development and production modes.

   Development Mode:

   Install the required dependencies:

   npm install

   Start the bot in watch mode (auto-reload when code changes):

   npm run dev

   Production Mode:

   Install only production dependencies (no development dependencies):

   npm install --only=prod

   Set the NODE_ENV environment variable to "production" in your .env file. Also, make sure to update BOT_WEBHOOK with the actual URL where your bot will receive updates.

   NODE_ENV=production
   BOT_WEBHOOK=<your_webhook_url>

   Start the bot in production mode:

   npm start
   # or
   npm run start:force # if you want to skip type checking

• npm run lint — Lint source code.
• npm run format — Format source code.
• npm run typecheck — Run type checking.
• npm run dev — Start the bot in development mode.
• npm run start — Start the bot.
• npm run start:force — Starts the bot without type checking.

Branch: deploy/docker-compose (open diff)

Use in your project:

1. Add the template repository as a remote

git remote add template [email protected]:bot-base/telegram-bot-template.git
git remote update

2. Merge deployment setup

git merge template/deploy/docker-compose -X theirs --squash --no-commit --allow-unrelated-histories

Branch: deploy/vercel (open diff)

Use in your project:

1. Add the template repository as a remote

git remote add template [email protected]:bot-base/telegram-bot-template.git
git remote update

2. Merge deployment setup

git merge template/deploy/vercel -X theirs --squash --no-commit --allow-unrelated-histories

Branch: example/orm-prisma (open diff)

Use in your project:

1. Add the template repository as a remote

git remote add template [email protected]:bot-base/telegram-bot-template.git
git remote update

2. Merge example

git merge template/example/orm-prisma -X theirs --squash --no-commit --allow-unrelated-histories

Branch: example/plugin-conversations (open diff)

Use in your project:

1. Add the template repository as a remote

git remote add template [email protected]:bot-base/telegram-bot-template.git
git remote update

2. Merge example

git merge template/example/plugin-conversations -X theirs --squash --no-commit --allow-unrelated-histories

Branch: example/plugin-runner (open diff)

Use in your project:

1. Add the template repository as a remote

git remote add template [email protected]:bot-base/telegram-bot-template.git
git remote update

2. Merge example

git merge template/example/plugin-runner -X theirs --squash --no-commit --allow-unrelated-histories

Branch: example/webapp (open diff)

Use in your project:

1. Add the template repository as a remote

git remote add template [email protected]:bot-base/telegram-bot-template.git
git remote update

2. Merge example

git merge template/example/webapp -X theirs --squash --no-commit --allow-unrelated-histories

Branch: example/webapp-vue (open diff)

Use in your project:

1. Add the template repository as a remote

git remote add template [email protected]:bot-base/telegram-bot-template.git
git remote update

2. Merge example

git merge template/example/webapp-vue -X theirs --squash --no-commit --allow-unrelated-histories