A clear path
to your own store.

Before you start

Miny 1.0.0 is a standalone React, TypeScript and Express application using Tebex Headless. It is not installed in the Tebex hosted theme editor.

• Node.js 22.13 or newer and npm.
• Hosting for a persistent Node.js server and an HTTPS domain.
• Your Tebex store, Headless API credentials and configured packages for live sales.
• Your own compatible game server delivery integration.

The supplied demo works without Tebex credentials. Hosting, domain registration, Tebex services and game server configuration are separate.

Start with the demo

Extract the buyer archive into a new application directory, outside a publicly downloadable web root.

npm ci
npm run configure
npm run dev

Open http://localhost:5230. The configurator preserves existing settings and creates a unique session secret when preparing a new environment.

Make it your own

Open /customize in demo mode. Preview your name, logo, background, colors, English and French copy, Discord invite, campaign and legal content. Export your configuration to store.config.json in the application root and restart the server.

News and FAQ content are in content/news.json and content/faq.json. Product overrides map your real Tebex product IDs to artwork and presentation. The sample catalogue is not automatically created in Tebex.

Connect your Tebex store

Configure packages, prices, durations, subscriptions, tiers and delivery commands in Tebex. Add your credentials to the server environment:

STORE_MODE=live
PUBLIC_ORIGIN=https://store.example.com
TEBEX_PUBLIC_TOKEN=your_store_token
TEBEX_PRIVATE_KEY=your_private_key
SESSION_SECRET=your_long_random_private_secret

Keep private values on the server. Never place them in browser JavaScript, screenshots or a public repository. Complete your seller identity and legal texts before enabling live mode.

The adapter creates and validates baskets server-side. Payments use the official Tebex checkout. Gift recipients use Tebex Ident. Tier upgrades and recurring billing depend on your own store configuration. The official customer portal handles sensitive purchase and subscription management.

Run the application

npm run build
npm start

Use a process manager or a managed Node.js service. Serve the website, its assets and /api from the same origin behind HTTPS. Set PUBLIC_ORIGIN to the exact public address.

For container hosting, use HOST=0.0.0.0 when required and keep the platform-provided PORT. On a VPS with a local reverse proxy, the default loopback address is appropriate. Set TRUST_PROXY_HOPS only for the actual trusted proxy chain.

On Hostinger’s managed Express hosting, select server.cjs as the entry file. This bridge supports its CommonJS launcher. Set NPM_CONFIG_INCLUDE=dev during installation so the TypeScript, Vite and esbuild build tools are available. Keep NODE_ENV=production for the deployed application.

Sessions use a JSON file. Use one application instance and persistent storage; configure SESSION_DATA_FILE for its location. Back up configuration, environment, custom content and session data.

Before opening the store

• Replace sample community information, counts and articles.
• Configure the Discord invitation and legal information.
• Map product artwork and rank benefits to the real catalogue.
• Create any advertised coupon in Tebex. The community goal is manually configured.
• Validate checkout and game delivery with Tebex test tools and your server.
• Test applicable gifting, refunds, renewal and upgrade scenarios.
• Check English, French and mobile presentation with your own content.

The supplied verification covers the demo purchase journey and simulated Tebex API contracts. It does not certify a live store or its game delivery setup.

Update with a way back

Back up the current installation, configuration, environment, custom content and data. Review the changelog, install into a separate directory and test there first. Preserve your configuration and secrets, then rebuild and switch your process to the verified version. Keep the previous release for rollback.

About this preview

The public Miny demo uses sample products, server counts and example community content. Checkout is simulated, with no real payment or in-game delivery. Preview settings are local to the visitor. Source and some visual assets were developed with substantial AI assistance; the package records the provenance and validation performed.