AuroraMC Overview
A premium Minecraft server store template built with React, Vite, and Tebex Headless API.
AuroraMC Store Template
AuroraMC is a premium, fully custom Minecraft server store template. Unlike standard Tebex themes, AuroraMC is a standalone web application built from the ground up with modern technologies — giving you complete control over every aspect of your storefront.
It connects directly to the Tebex Headless API for secure payment processing and package delivery, while providing a polished shopping experience with glassmorphism effects, smooth animations, and a responsive layout that works across all devices.
Features
- Tebex Headless Checkout — Basket creation, package selection, and redirect to Tebex payment in one seamless flow
- Live Server Status — Real-time player count and server status pulled from your Minecraft server via mcsrvstat.us
- Shopping Cart — Full cart system with quantity controls, discount code support, and price calculations
- Discount Codes — Built-in coupon system with percentage discounts, usage limits, and expiry dates
- Category Browsing — Organize products into categories and subcategories with color-coded cards
- Top Donators & Recent Purchases — Social proof widgets showing recent activity and leaderboard
- Monthly Goal Tracker — Visual donation goal progress bar
- Legal Pages — Pre-built Terms, Privacy, Refund, and Rules pages ready to customize
- Error Boundary — Graceful error handling so your store never shows a blank page
- Lazy Loading — Secondary pages are code-split for faster initial load times
- SEO Ready — Configurable meta tags, title, description, and keywords
Technology Stack
| Layer | Technology |
|---|---|
| Framework | React 18 with Vite 6 |
| Language | TypeScript 5.6 |
| Styling | Tailwind CSS 3 with tailwindcss-animate |
| UI Primitives | Radix UI (Dialog, Accordion, Tabs, Tooltip, etc.) |
| Animations | Framer Motion 11 |
| Icons | Lucide React and React Icons |
| Routing | React Router v7 |
| Notifications | Sonner toast system |
| Forms | React Hook Form with Zod validation |
| Payments | Tebex Headless API |
Why AuroraMC Over Standard Tebex Themes?
- Full Ownership — You own the source code. Customize anything without theme restrictions.
- Faster Performance — Optimized Vite build with code-splitting and tree-shaking produces a lightweight static bundle.
- Better UX — Custom cart, product modals, interactive animations, and a checkout flow that standard Tebex themes cannot replicate.
- Static Hosting — The production build is a plain
dist/folder. No server runtime needed — host it on Vercel, Netlify, or any web server.
Next Steps
Installation
Set up your development environment and get the store running locally.
Configuration
Customize branding, products, discounts, and feature toggles.
Project Structure
Understand the codebase layout and component architecture.
Tebex Integration
Set up payments and connect your products to Tebex.
Customization
Theme colors, typography, animations, and visual tweaks.
Deployment
Build and deploy your store to production.