Hub

hub.tribewarez.com

A terminal-style game launcher that displays all TribeWarez games, checks their live status, and serves as the central directory for the ecosystem.

Features

Game Directory

The Hub displays cards for each game in the ecosystem:

Game	Category	URL
Numerology Match (Mystic Numbers)	Puzzle	mystic.tribewarez.com
Numerology Wars	Strategy	wars.tribewarez.com
Angels95	Retro Arcade	--
Wargamez	PvP Arena	--

Game metadata is stored in games.json (id, name, URL, icon, category).

Live Status Checks

The Hub pings each game URL with HEAD requests to determine online/offline status. The status badge updates in real time on each game card.

API endpoints:

Endpoint	Purpose
GET /api/games	Returns the full game list from games.json
GET /api/status/:gameId	HEAD-checks the game URL and returns online/offline
GET /health	Health check for the Hub itself

Ad System

Configurable ad widgets defined in ads.json:

Type	Placement
Image ads	Sidebar, bottom
Iframe embeds	Inline
Popup ads	Timed delay

Each ad entry specifies id, type, position, delay, image URL, and click-through URL.

SEO

The Hub includes full SEO metadata:

• Open Graph and Twitter Card meta tags
• JSON-LD structured data
• sitemap.xml and robots.txt

Tech Stack

Layer	Technology
Runtime	Node.js
Server	Express
Frontend	Vanilla JS, HTML
Fonts	VT323, Share Tech Mono
Middleware	CORS

Visual Style

Retro terminal aesthetic:

• VT323 and Share Tech Mono monospace fonts
• Dark background with phosphor-green accents
• Card-based game grid layout

Docker

Built with Node 18 Alpine in a multi-stage Dockerfile. The Express server serves static files from public/ and the game/status APIs.

Exposed internally and routed via VIRTUAL_HOST=hub.tribewarez.com.

Architecture & RPC Proposals

As the ecosystem hub, hub.tribewarez.com should act as a map of the PoT-O-based architecture:

• Present PoT-O, DeFi, docs, terminal, and numerology apps as parts of a single architecture, with short summaries that match TW-RPC-001/003/004/005.
• Link to the PoT-O RFC Series and Implementation Mapping for readers who want protocol-level details.

Footer & Navigation (Spec)

The Hub’s navigation/footer can help users jump into the right tools and docs:

• PoT-O RFCs → https://docs.tribewarez.com/public/
• Architecture & Docs → https://docs.tribewarez.com
• Status Dashboard → https://status.rpc.gateway.tribewarez.com
• Testnet & Validator API → https://testnet-solana.rpc.gateway.tribewarez.com and https://pot.rpc.gateway.tribewarez.com
• Apps → links to Terminal, DeFi, Mystic Numbers, Numerology Wars, and other ecosystem titles.

This makes the Hub a canonical starting point for exploring both the apps and the underlying PoT-O infrastructure.