{"id":24563697,"url":"https://github.com/mildronize/telegram-bot","last_synced_at":"2025-06-23T07:04:20.606Z","repository":{"id":272002510,"uuid":"915204280","full_name":"mildronize/telegram-bot","owner":"mildronize","description":"Individually Bot designed from private single user personal help","archived":false,"fork":false,"pushed_at":"2025-03-15T02:43:00.000Z","size":516,"stargazers_count":1,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-17T00:27:18.622Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mildronize.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-11T08:33:26.000Z","updated_at":"2025-03-15T11:09:58.000Z","dependencies_parsed_at":"2025-01-23T10:15:38.911Z","dependency_job_id":null,"html_url":"https://github.com/mildronize/telegram-bot","commit_stats":null,"previous_names":["mildronize/my-bot"],"tags_count":0,"template":false,"template_full_name":"EdJoPaTo/telegram-typescript-bot-template","purl":"pkg:github/mildronize/telegram-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mildronize%2Ftelegram-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mildronize%2Ftelegram-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mildronize%2Ftelegram-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mildronize%2Ftelegram-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mildronize","download_url":"https://codeload.github.com/mildronize/telegram-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mildronize%2Ftelegram-bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261434111,"owners_count":23157201,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-23T10:15:15.272Z","updated_at":"2025-06-23T07:04:15.587Z","avatar_url":"https://github.com/mildronize.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# telegram-typescript-bot-template\n\n\u003e Template for Telegram bots written in TypeScript\n\nIf you haven't written TypeScript before, don't be scared of it.\nIt is nearly the same as JavaScript.\nBut it provides more helpful information before something goes wrong during the runtime.\n\nI learned a lot about JavaScript itself when I started diving into TypeScript.\n\n## Install\n\n```bash\nnpm install\n```\n\n## Start the bot\n\n### Local development\n\nWrite to the @BotFather on Telegram and create your bot.\nYou will get a token that looks like this: `123:abc`.\nUse it as an environment variable (for example via `.env` file or `export BOT_TOKEN=123:abc`).\nTip: When you create a separate bot for your development you can use production and development in parallel.\n\nThe bot stores persistent data within the `persist` folder.\nSo also create this folder before starting it for the first time.\n\n```bash\nmkdir persist\n```\n\nThen go ahead and start the bot\n\n```bash\nnpm start\n```\n\n### Production\n\nSee the Dockerfile.\nYou can build a container using it.\nBut this repo isn't about containers.\nFor more information about them, take a look elsewhere.\n\nThe container is meant to be used with an environment variable named `BOT_TOKEN`.\n\nThe container has one volume (`/app/persist`) which will contain persistent data your bot creates.\nMake sure to explicitly use that volume (for example, make sure it's synced or tied to the host in a multi-node setup).\n\n## Basic Folder structure example\n\n- `source` contains your TypeScript source files. Subfolders contain specifics about your implementation\n  - `bot` may contain files relevant for the telegram bot\n    - `menu` may contain specifics about the bot, the menu that is shown on /start\n  - `magic` may contain something relevant for doing magic. It is not relevant to the bot directly, but it is used by it.\n- `locales` contains translation strings for your bot. That way it can speak multiple languages.\n- `dist` will contain transpiled JavaScript files.\n- `persist` will contain persistent data your bot uses. Make sure to keep that data persistent (Backups for example).\n\n## Improve\n\nDo you think something is missing?\nFeel free to add it.\nThen everyone can learn that even easier than before :)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmildronize%2Ftelegram-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmildronize%2Ftelegram-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmildronize%2Ftelegram-bot/lists"}