EZIOX

The Bio Link Platform for Creators

 ███████╗███████╗██╗ ██████╗ ██╗  ██╗
 ██╔════╝╚══███╔╝██║██╔═══██╗╚██╗██╔╝
 █████╗    ███╔╝ ██║██║   ██║ ╚███╔╝
 ██╔══╝   ███╔╝  ██║██║   ██║ ██╔██╗
 ███████╗███████╗██║╚██████╔╝██╔╝ ██╗
 ╚══════╝╚══════╝╚═╝ ╚═════╝ ╚═╝  ╚═╝

Your personalized bio page | Real-time analytics | Climb the leaderboard

Live Demo | Report Bug | Request Feature

---

// FEATURES

┌─────────────────────────────────────────────────────────────────────────────┐
│  CORE                                                                       │
├─────────────────────────────────────────────────────────────────────────────┤
│  > Bio Links .............. Linktree-style customizable link pages          │
│  > Profile Comments ....... Comment system with likes & moderation          │
│  > Internationalization ... Full i18n support (English & German)            │
│  > Premium Tiers .......... Free, Pro, Creator & Lifetime subscriptions     │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│  ANALYTICS                                                                  │
├─────────────────────────────────────────────────────────────────────────────┤
│  > Link Analytics ......... Per-link tracking with device & geo data        │
│  > Click Heatmaps ......... Visual representation of user engagement        │
│  > Link Scheduling ........ Schedule links with start/end dates             │
│  > Real-time Stats ........ Live view counts and click tracking             │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│  CUSTOMIZATION                                                              │
├─────────────────────────────────────────────────────────────────────────────┤
│  > 31 Themes .............. Modern themes across 8 categories               │
│  > Theme Builder .......... Create custom themes with live preview          │
│  > Animated Backgrounds ... Gradient, particle & wave effects               │
│  > Custom Avatars ......... Upload or use Gravatar integration              │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│  INTEGRATIONS                                                               │
├─────────────────────────────────────────────────────────────────────────────┤
│  > Spotify ................ Display currently playing music                 │
│  > Discord ................ OAuth login & profile linking                   │
│  > Twitch ................. Stream status & follower count                  │
│  > GitHub ................. Repository showcase                             │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│  SECURITY                                                                   │
├─────────────────────────────────────────────────────────────────────────────┤
│  > Passkey/WebAuthn ....... Passwordless biometric authentication           │
│  > OTP Login .............. Email-based one-time password login             │
│  > Two-Factor Auth ........ TOTP-based 2FA with recovery codes              │
│  > Cloudflare Turnstile ... Bot protection on auth pages                    │
│  > CSRF Protection ........ Token-based request validation                  │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│  SUPPORT                                                                    │
├─────────────────────────────────────────────────────────────────────────────┤
│  > Ticket System ......... Live support tickets with 5 categories           │
│  > Admin Panel .......... Complete ticket management for staff              │
│  > Email Notifications ... Confirmation emails on ticket creation           │
│  > Guest Support ........ Non-registered users can submit tickets           │
│  > Priority Levels ...... Low, Normal, High, Urgent ticket priorities       │
└─────────────────────────────────────────────────────────────────────────────┘

---

// PREMIUM TIERS

╔═══════════════╦════════════╦═════════════════════════════════════════════════╗
║ TIER          ║ PRICE      ║ HIGHLIGHTS                                      ║
╠═══════════════╬════════════╬═════════════════════════════════════════════════╣
║ Eziox Core    ║ Free       ║ Unlimited links, all themes, full analytics     ║
║ Pro           ║ €2.99/mo   ║ Custom CSS, fonts, remove branding, backups     ║
║ Creator       ║ €5.99/mo   ║ Custom domain, password links, priority support ║
║ Lifetime      ║ €29 once   ║ All Creator features forever, exclusive badge   ║
╚═══════════════╩════════════╩═════════════════════════════════════════════════╝

---

// TECH STACK

FRONTEND
├── React 19 ................. UI Framework
├── TypeScript 5.9 ........... Type Safety
├── TanStack Start ........... SSR Framework
├── TanStack Router .......... File-based Routing
├── TanStack Query ........... Data Fetching
├── Tailwind CSS 4 ........... Styling
├── shadcn/ui ................ Component Library
└── Motion ................... Animations

BACKEND
├── Neon PostgreSQL .......... Database
├── Drizzle ORM .............. Database Toolkit
├── Bun Runtime .............. JavaScript Runtime
└── bcrypt ................... Password Hashing

DEPLOYMENT
├── Vercel Edge .............. Hosting & CDN
└── GitHub Actions ........... CI/CD Pipeline

---

// QUICK START

# Clone the repository
git clone https://github.com/Eziox-Development/eziox-web.git
cd eziox-web

# Install dependencies
bun install

# Configure environment
cp .env.example .env
# Edit .env with your credentials

# Push database schema
bun run db:push

# Start development server
bun run dev

Environment Variables

# Required
DATABASE_URL=postgresql://...@ep-xxx.neon.tech/neondb?sslmode=require
AUTH_SECRET=your-super-secret-key
APP_URL=https://your-domain.com

# Cloudflare Turnstile
TURNSTILE_SECRET_KEY=0x...
VITE_TURNSTILE_SITE_KEY=0x...

# Stripe Payments
STRIPE_SECRET_KEY=sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...

# OAuth Integrations
DISCORD_CLIENT_ID=...
DISCORD_CLIENT_SECRET=...
SPOTIFY_CLIENT_ID=...
SPOTIFY_CLIENT_SECRET=...

Get your DATABASE_URL from console.neon.tech Get Stripe keys from dashboard.stripe.com

---

// SCRIPTS

bun run dev          # Start development server
bun run build        # Production build
bun run lint         # Lint code
bun run format       # Format code
bun run db:push      # Push database schema
bun run db:studio    # Open Drizzle Studio

---

// PROJECT STRUCTURE

src/
├── components/          # React components
│   ├── auth/            # Authentication components
│   ├── bio/             # Bio page components
│   ├── layout/          # Layout & navigation
│   ├── profile/         # Profile dashboard
│   └── ui/              # shadcn/ui components
├── hooks/               # Custom React hooks
├── lib/                 # Utilities & config
├── locales/             # i18n translations (en, de)
├── routes/              # TanStack Router routes
│   ├── _auth/           # Auth routes (sign-in, sign-up)
│   ├── _protected/      # Protected routes (profile, admin)
│   ├── _public/         # Public routes (home, pricing)
│   └── $username.tsx    # Dynamic bio page route
└── server/              # Server-side code
    ├── db/              # Database schema & migrations
    ├── functions/       # Server functions (RPC)
    └── lib/             # Auth, email, security utilities

---

// DEPLOYMENT

Deployed automatically via Vercel on push to main.

See DEPLOYMENT.md for detailed instructions.

---

// CONTRIBUTING

Contributions are welcome! You can contribute by:

• Reporting Issues - Found a bug? Create an issue
• Suggesting Features - Have an idea? Open a feature request
• Code Contributions - Submit Pull Requests to fix bugs or improve features

Note: This is a Source Available project. You can view and contribute to the code, but redistribution and commercial use require permission.

---

// LICENSE

This project is licensed under the PolyForm Noncommercial License 1.0.0 - see the LICENSE file for details.

PERMITTED                           PROHIBITED
─────────────────────────────────   ─────────────────────────────────
[+] View and study source code      [-] Commercial use without license
[+] Personal, non-commercial use    [-] Sell or monetize the software
[+] Contribute via Issues & PRs     [-] Offer as a hosted service
[+] Educational purposes            [-] Remove copyright notices

For commercial licensing, contact: business@eziox.link

---

╔═══════════════════════════════════════════════════════════════════════════╗
║                                                                           ║
║                         EZIOX DEVELOPMENT                                 ║
║                                                                           ║
║                    Built for Creators, by Creators                        ║
║                                                                           ║
╚═══════════════════════════════════════════════════════════════════════════╝

Website | GitHub | Issues