Skip to content

About

TeleX Store- Telegram Bot Store & Admin Dashboard. Full-stack platform with order management, digital vault, ewallet, workflow builder, payment methods, broadcast, and channel notification system.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

206 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TeleX Store — Telegram Bot Store & Admin Dashboard

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.

Node.js React SQLite Vite License


What is TeleX Store?

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.


Features

🛒 Store & Orders

  • 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

🔐 Digital Vault

  • 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

💳 Ewallet System

  • Customer wallet with top-up via QR payment
  • Admin-controlled balance adjustments
  • Transaction history and wallet stats
  • Insufficient balance notifications

💬 Workflow Builder

  • 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

📢 Broadcasts

  • Send messages to all subscribers or filtered segments
  • Schedule broadcasts
  • Track sent, failed, and blocked counts

🔔 Order Notifications

  • Connect a separate Telegram bot to any channel or group
  • Receive real-time notifications for new orders and receipt uploads
  • Per-event toggle control

🤖 Bot Management

  • Multi-bot support
  • Bot mode control: Online, Offline, Maintenance, Holiday
  • Custom messages per mode
  • Webhook management

👥 Subscribers

  • Auto-capture customer data on first interaction
  • Tag and note management
  • Subscriber search and filtering

📊 Dashboard & Logs

  • Revenue, order, and subscriber stats
  • Store activity logs per order
  • Audit logs for admin actions
  • API call logs

Tech Stack

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)

Project Structure

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

Getting Started

Prerequisites

  • Node.js 18+
  • A Telegram Bot Token from @BotFather

Backend Setup

cd backend
cp .env.example .env
# Fill in your environment variables
npm install
npm start

Frontend Setup

cd frontend
npm install
npm run dev

Environment Variables

PORT=3001
JWT_SECRET=your_jwt_secret
ENCRYPTION_KEY=your_32_char_encryption_key
DB_PATH=./data/telexstore.db

Deployment

Backend — Railway

The backend is configured for Railway deployment with railway.toml and Procfile included.

Frontend — Cloudflare Pages

Build command: npm run build Output directory: dist Set VITE_API_URL to your Railway backend URL.


How It Works

  1. Customer sends /start to your Telegram bot
  2. Bot responds with your configured welcome flow and store menu
  3. Customer selects a product and chooses payment method
  4. For manual payment: bot sends QR image and waits for receipt upload
  5. For ewallet: balance is deducted instantly and product is delivered
  6. Admin receives notification in dashboard and Telegram channel
  7. Admin approves payment → digital product is auto-delivered to customer

Screenshots

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

Roadmap

  • Stripe / FPX payment gateway integration
  • Customer-facing web storefront
  • Multi-language support
  • Product image upload
  • Discount codes & promotions
  • Affiliate / referral system

License

MIT License — see LICENSE for details.


Author

Built by @shaarur

TeleX Store — Sell smarter. Deliver faster. Automate everything.

About

TeleX Store- Telegram Bot Store & Admin Dashboard. Full-stack platform with order management, digital vault, ewallet, workflow builder, payment methods, broadcast, and channel notification system.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages