|
1 | 1 | --- |
2 | | -title: GramIO guides - Powerful framework for creating Telegram bots with TypeScript/JavaScript |
3 | | - |
| 2 | +title: GramIO Guides — Learning Path for Telegram Bot Development |
4 | 3 | head: |
5 | 4 | - - meta |
6 | 5 | - name: "description" |
7 | | - content: "Comprehensive guides and tutorials for the GramIO framework - learn how to create feature-rich Telegram bots with TypeScript and JavaScript. From basic setup to advanced techniques." |
8 | | - |
| 6 | + content: "GramIO guides for every skill level — from your first bot to production-ready architecture. Beginner tutorials, topic deep-dives, and advanced patterns." |
9 | 7 | - - meta |
10 | 8 | - name: "keywords" |
11 | | - content: "telegram bot, framework, how to create a bot, Telegram, Telegram Bot API, GramIO, TypeScript, JavaScript, Node.JS, Nodejs, Deno, Bun, bot development guides, tutorials, step-by-step instructions, API documentation, Telegram bot development, learning materials, practical examples, bot code examples" |
| 9 | + content: "GramIO guides, telegram bot tutorial, TypeScript bot guide, bot development learning path, beginner telegram bot, GramIO examples" |
| 10 | +--- |
| 11 | + |
| 12 | +# Guides |
| 13 | + |
| 14 | +Practical guides for building Telegram bots with GramIO — from your first `/start` command to production-scale architecture. |
| 15 | + |
12 | 16 | --- |
13 | 17 |
|
14 | | -# GramIO Guides |
| 18 | +## Beginner Path |
| 19 | + |
| 20 | +New to GramIO or Telegram bots in general? Start here. This series walks you through building a real bot from scratch, explaining the concepts as you go. |
| 21 | + |
| 22 | +| Step | What you'll learn | |
| 23 | +|------|-------------------| |
| 24 | +| [1. Introduction](/guides/for-beginners/1) | What GramIO is, how Telegram bots work, getting your bot token | |
| 25 | +| [2. First steps](/guides/for-beginners/2) | Setting up the project, handling your first command | |
| 26 | +| [3. TypeScript & keyboards](/guides/for-beginners/3) | Type safety in practice, inline and reply keyboards | |
| 27 | + |
| 28 | +--- |
| 29 | + |
| 30 | +## Topic Guides |
| 31 | + |
| 32 | +Focused deep-dives on specific features and integrations. |
15 | 33 |
|
16 | | -Welcome to the GramIO guides section. Here you'll find detailed information and tutorials to help you create amazing Telegram bots with the GramIO framework. |
| 34 | +### Bot Setup & Deployment |
17 | 35 |
|
18 | | -## Contents |
| 36 | +- [Get started](/get-started) — Scaffold, run, and understand the project structure |
| 37 | +- [Webhooks](/guides/webhook) — Run your bot on a web server instead of long polling |
| 38 | +- [Docker](/guides/docker) — Containerize your bot for easy deployment |
19 | 39 |
|
20 | | -- [Getting Started](/get-started) - Quick start guide for creating your first bot |
21 | | -- [Bot API](/bot-api) - Learn about the Telegram Bot API specifics |
22 | | -- [Bot Class](/bot-class) - Understanding the main Bot class and its features |
23 | | -- [Plugins](/plugins/overview) - Extend your bot's functionality with plugins |
24 | | -- [Hooks](/hooks/overview) - React to different events in your bot's lifecycle |
25 | | -- [Formatting](/formatting/format) - Style your messages with formatting tools |
26 | | -- [Keyboards](/keyboards/overview) - Add interactive buttons to your bot |
| 40 | +### Payments & Monetization |
27 | 41 |
|
28 | | -## Project Examples |
| 42 | +- [Telegram Stars](/guides/telegram-stars) — Accept payments with Telegram's native payment system |
29 | 43 |
|
30 | | -We'll be adding complete project examples soon to demonstrate how to build various types of bots with GramIO. |
| 44 | +### Filtering & Routing |
| 45 | + |
| 46 | +- [Filters](/guides/filters) — Route updates to the right handler with composable filter functions |
| 47 | + |
| 48 | +### AI & Tooling |
| 49 | + |
| 50 | +- [AI Skills](/guides/ai-skills) — Give your AI assistant deep GramIO knowledge with installable skills |
| 51 | + |
| 52 | +### Migrating from another framework |
| 53 | + |
| 54 | +- [Migrate from grammY](/guides/migration-from-grammy) — Side-by-side code comparisons for grammY users |
| 55 | +- [Migrate from puregram](/guides/migration-from-puregram) — Side-by-side code comparisons for puregram users |
| 56 | + |
| 57 | +--- |
| 58 | + |
| 59 | +## Quick references |
| 60 | + |
| 61 | +Already know the basics? Jump straight to what you need: |
| 62 | + |
| 63 | +- [Cheat Sheet](/cheat-sheet) — Most common patterns in one page |
| 64 | +- [Bot API](/bot-api) — How GramIO maps to the Telegram Bot API |
| 65 | +- [Formatting](/formatting) — Bold, italic, code, spoilers without `parse_mode` |
| 66 | +- [Keyboards](/keyboards/overview) — Inline, reply, remove, force-reply keyboards |
| 67 | +- [Triggers](/triggers/hears) — Commands, hears, callback queries, inline queries |
| 68 | +- [Hooks](/hooks/overview) — onStart, onStop, onError, preRequest, onResponse |
| 69 | +- [Files](/files/overview) — Upload, download, reuse media |
| 70 | +- [Plugins](/plugins/overview) — Sessions, scenes, i18n, and more |
| 71 | +- [Testing](/testing) — Test your bot with `@gramio/test` |
| 72 | + |
| 73 | +--- |
31 | 74 |
|
32 | | -## Feedback |
| 75 | +## Need help? |
33 | 76 |
|
34 | | -Have suggestions for new guides or found an issue? Feel free to create an issue in our [GitHub repository](https://github.com/gramiojs/docs/issues). |
| 77 | +- Browse the [Telegram API Reference](/telegram/) — every method with GramIO examples |
| 78 | +- Open an issue on [GitHub](https://github.com/gramiojs/gramio/issues) |
| 79 | +- Chat in the [GramIO Telegram community](https://t.me/gramio_forum) |
0 commit comments