{"id":26710743,"url":"https://github.com/mohnate/woo-kit","last_synced_at":"2025-08-29T17:18:06.608Z","repository":{"id":281018098,"uuid":"943936968","full_name":"mohnate/woo-kit","owner":"mohnate","description":"Telegram mini app integration with WooCommerce","archived":false,"fork":false,"pushed_at":"2025-03-06T14:15:28.000Z","size":1522,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-27T09:42:26.578Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://t.me/MiniWooBot","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/mohnate.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-03-06T14:11:44.000Z","updated_at":"2025-03-06T14:16:01.000Z","dependencies_parsed_at":"2025-03-06T15:36:54.095Z","dependency_job_id":null,"html_url":"https://github.com/mohnate/woo-kit","commit_stats":null,"previous_names":["mohnate/woo-kit"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mohnate/woo-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohnate%2Fwoo-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohnate%2Fwoo-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohnate%2Fwoo-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohnate%2Fwoo-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mohnate","download_url":"https://codeload.github.com/mohnate/woo-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohnate%2Fwoo-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272731414,"owners_count":24983924,"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","status":"online","status_checked_at":"2025-08-29T02:00:10.610Z","response_time":87,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-03-27T09:35:01.868Z","updated_at":"2025-08-29T17:18:06.564Z","avatar_url":"https://github.com/mohnate.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mini Woo: A Telegram Mini App for WooCommerce\n\nMini Woo is a project that allows you to create a [mini app](https://core.telegram.org/bots/webapps) for [Telegram](https://telegram.org/), the messaging app with over 500 million active users, that connects to your [WooCommerce](https://woocommerce.com/) website, the most popular e-commerce platform on the web. \n\n![Brief video](./.github/mini-woo.gif \"Short video showing opening the shop, browsing products, adding to cart, and paying with Telegram.\")\n\nIt uses [Next.js](https://nextjs.org/), a React framework for building fast and scalable web applications, and the Telegram [Bot API](https://core.telegram.org/bots/api) and the WooCommerce [REST API](https://woocommerce.github.io/woocommerce-rest-api-docs/) to provide a seamless shopping experience for your customers on Telegram. \n\nYou can use this project as a template to customize your mini app with your own branding, products, and features, or modify the API to connect any other online store that supports RESTful web services. This project is open source and free to use. You can find the source code, documentation, and installation instructions [here on GitHub](https://github.com/mohnate/woo-kit).\n\n## Requirements\n\n- Telegram Bot\n- WooCommerce Website\n- NodeJs (Latest LTS version recommended)\n\n\n## Getting Started\n\n1. Prepare Environment Variables\n2. Deploy\n3. Init Telegram Bot API Webhook\n\n### Environment Variables\n\nTo use this project, you need to set the following environment variables:\n\n- `NEXT_PUBLIC_BASE_PATH`\n  This is the base URL of your deployment. For example, if you are deploying on Vercel, it can be something like `https://mini-woo-\u003cyour-username\u003e.vercel.app`.\n\n\n- `TELEGRAM_BOT_TOKEN`\n  This is the access token that you get from [@BotFather](https://t.me/BotFather) when you create your Telegram bot.\n- `TELEGRAM_BOT_SECRET`\n  This is a password that you set to secure your APIs. It can be any string, such as `my-pass` or a randomly generated hash. Please make sure to keep it secret.\n- `TELEGRAM_PAYMENT_PROVIDER_TOKEN`\n  This is telegram payment provider token. You can connect payment methods from BotFather. [Payment Providers](https://core.telegram.org/bots/payments#supported-payment-providers), [Supported Currencies](https://core.telegram.org/bots/payments#supported-currencies)\n\n\n- `WOOCOMMERCE_URL`\n  This is the URL of your WooCommerce website. For example, `https://\u003cyour-super-cool-store\u003e.com`.\n- `WOOCOMMERCE_CONSUMER_KEY` `WOOCOMMERCE_CONSUMER_SECRET`\n  These are the authentication key and secret that you obtain from WooCommerce settings. You can follow this [instruction](https://woocommerce.github.io/woocommerce-rest-api-docs/?shell#rest-api-keys) to generate them.\n\n### Deploy\n\nYou need to deploy your app on a platform or a server of your choice.\n\n#### Deploy on Vercel\n\nThe easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template\u0026filter=next.js\u0026utm_source=create-next-app\u0026utm_campaign=create-next-app-readme) from the creators of Next.js.\nYou need to fork this repository first.\n\nCheck out [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.\n\n#### Deploy on Server\n\nIf you prefer to deploy your app on your own server, you need to copy `example.env` to `.env `in the root of the project and fill the variables. Then, you need to run the following commands:\n\n```bash\nnpm run build\n\nnpm run start\n```\nThis will build and start your app on the port specified by the `PORT` variable in `.env`.\n\n#### Run Locally for Development\n\nSet environment variables then run:\n\n```bash\nnpm run dev\n```\n\nyou can use https://ngrok.com/\n\n### Init Telegram Bot API Webhook\n\nThis is the last step! You need to set up a webhook for your Telegram bot to receive updates from Telegram. To do this, you just need to make a POST request to the following URL:\n\n```bash\ncurl -X POST https://\u003cyour-deployment-url\u003e/api/telegram-hook/init?secret_hash=\u003cthe-secret-password-from-env-var\u003e\n```\n\nReplace `\u003cyour-deployment-url\u003e` with the base URL of your deployment and `\u003cthe-secret-password-from-env-var\u003e` with the value of `TELEGRAM_BOT_SECRET` in your environment variables or `.env`.\n\nNow your mini app is ready! You can test it by sending commands or messages to your Telegram bot. Enjoy! 😊\n\n## Features\n\n- [x] Show products list\n- [x] Filter by category\n- [x] Register Order\n- [x] Pay with telegram payment\n- [ ] Support variable items\n- [ ] Support search items\n- [ ] Support shipping methods\n- [ ] Support other payment methods\n- [ ] more...\n\n## Learn More\n\nTo learn more, take a look at the following resources:\n\n- [Telegram Mini App](https://core.telegram.org/bots/webapps) - Starting point to learn about telegram web apps.\n- [Telegram Bot API](https://core.telegram.org/bots/api) - Telegram Bot API full documentation.\n- [Telegraf.js](https://telegraf.js.org/index.html) - Modern Telegram Bot API framework for Node.js (documents).\n- [WooCommerce API](https://woocommerce.github.io/woocommerce-rest-api-docs) - WooCommerce REST api documentation.\n- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.\n- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.\n\nYour feedback and contributions are welcome!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohnate%2Fwoo-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmohnate%2Fwoo-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohnate%2Fwoo-kit/lists"}