A full-stack platform to run your digital store entirely through Telegram. Manage orders, deliver digital products, accept payments, and automate customer interactions — all from one sleek admin dashboard.
TeleX Store turns your Telegram bot into a fully functional e-commerce store. Customers browse products, make payments, and receive digital goods — all inside Telegram. You manage everything from a powerful admin dashboard: approve orders, monitor stock, run broadcasts, and build automated workflows without writing a single line of code.
Built for digital product sellers, SaaS resellers, and anyone who wants to sell through Telegram with zero friction.
- Product catalog with categories, pricing, and stock management
- Manual QR payment and Ewallet balance payment support
- Order lifecycle management — pending, receipt upload, admin approval, delivery
- Receipt image viewer directly in the admin dashboard
- Delete, cancel, reject, and resend order notifications
- Secure stock management for license keys, account credentials, voucher codes, download links, serial keys, and custom text
- Bulk upload support
- Auto-delivery upon order approval
- Stock masking for privacy
- Customer wallet with top-up via QR payment
- Admin-controlled balance adjustments
- Transaction history and wallet stats
- Insufficient balance notifications
- Visual drag-and-drop flow builder (React Flow)
- Trigger types: command, keyword, button, any message
- Node types: Trigger, Message, Product List, Ewallet
- Inline buttons with custom emoji icons, color prefixes, and Telegram native styles
- Variable injection:
{{name}},{{id}},{{username}},{{balance}} - Save, edit, and manage workflows from Saved Workflows tab
- Send messages to all subscribers or filtered segments
- Schedule broadcasts
- Track sent, failed, and blocked counts
- Connect a separate Telegram bot to any channel or group
- Receive real-time notifications for new orders and receipt uploads
- Per-event toggle control
- Multi-bot support
- Bot mode control: Online, Offline, Maintenance, Holiday
- Custom messages per mode
- Webhook management
- Auto-capture customer data on first interaction
- Tag and note management
- Subscriber search and filtering
- Revenue, order, and subscriber stats
- Store activity logs per order
- Audit logs for admin actions
- API call logs
| Layer | Technology |
|---|---|
| Frontend | React 18, Vite 5, React Flow, Lucide Icons |
| Backend | Node.js, Express.js |
| Database | SQLite via better-sqlite3 |
| Bot API | Telegram Bot API (polling via webhook) |
| Auth | JWT-based admin authentication |
| Deployment | Railway (backend), Cloudflare Pages (frontend) |
TeleXStore/
├── backend/
│ ├── src/
│ │ ├── db/ # Database schema & migrations
│ │ ├── middleware/ # Auth middleware
│ │ ├── routes/ # API route handlers
│ │ └── services/ # Business logic (orders, payments, notifications, vault)
│ └── server.js # Express entry point
└── frontend/
└── src/
├── components/ # Shared UI components
├── hooks/ # Auth & bot hooks
├── pages/ # All page components
└── services/ # API client
- Node.js 18+
- A Telegram Bot Token from @BotFather
cd backend
cp .env.example .env
# Fill in your environment variables
npm install
npm startcd frontend
npm install
npm run devPORT=3001
JWT_SECRET=your_jwt_secret
ENCRYPTION_KEY=your_32_char_encryption_key
DB_PATH=./data/telexstore.dbThe backend is configured for Railway deployment with railway.toml and Procfile included.
Build command: npm run build
Output directory: dist
Set VITE_API_URL to your Railway backend URL.
- Customer sends
/startto your Telegram bot - Bot responds with your configured welcome flow and store menu
- Customer selects a product and chooses payment method
- For manual payment: bot sends QR image and waits for receipt upload
- For ewallet: balance is deducted instantly and product is delivered
- Admin receives notification in dashboard and Telegram channel
- Admin approves payment → digital product is auto-delivered to customer
| Dashboard | Orders | Workflow Builder |
|---|---|---|
| Revenue & stats overview | Order management with receipt viewer | Visual drag-and-drop flow editor |
| Digital Vault | Notifications | Payment Methods |
|---|---|---|
| Stock management & delivery | Channel notification setup | QR & Ewallet configuration |
- Stripe / FPX payment gateway integration
- Customer-facing web storefront
- Multi-language support
- Product image upload
- Discount codes & promotions
- Affiliate / referral system
MIT License — see LICENSE for details.
Built by @shaarur
TeleX Store — Sell smarter. Deliver faster. Automate everything.