Skip to content
@gamv-io

gamv.io

Web3 Game Store Platform — Play, Build, Earn
README.md
Gamvio

Gamvio

The Web3 Game Store

Play 75+ browser games · Earn token rewards · Build and publish your own games

Play Now SDK Docs npm

What is Gamvio?

Gamvio is a Web3 game store platform where players discover and play browser-based games while earning blockchain token rewards. Developers can integrate their games through our SDK and tap into a built-in player base with leaderboards, quests, and a token economy.

For Players

  • 75+ instant-play games — arcade, puzzle, strategy, board, card, brain teasers
  • Earn POINT tokens — rewards for playing, daily quests, and check-in streaks
  • Global leaderboards — compete for top rankings on every game
  • Free to play — no downloads, no installs, play in your browser

For Developers

  • One-command setup — npx create-gamvio-game my-game
  • Anti-cheat scoring — HMAC-SHA256 signed, server-verified score submissions
  • Built-in economy — automatic POINT token rewards for players of your game
  • Leaderboards included — global and weekly rankings per game, zero config
  • Test mode — develop locally with instant test tokens, no platform login needed

Quick Start for Developers

# 1. Scaffold a new game project
npx create-gamvio-game my-game
cd my-game

# 2. Add your SDK credentials (from dev.gamv.io)
cp .env.example .env.local

# 3. Start development — test mode activates automatically on localhost
npm install
npm run dev

How It Works

┌─────────────────┐      ┌──────────────────┐      ┌─────────────────┐
│   Your Game      │      │   Your Server     │      │   Gamvio API     │
│   (Browser)      │ ───► │   (Next.js)       │ ───► │   (gamv.io)      │
│                  │      │                   │      │                  │
│  useGamvio()     │      │  HMAC signing     │      │  Score verify    │
│  submitScore()   │      │  Session mgmt     │      │  Leaderboard     │
│  getLeaderboard()│      │  Secrets safe     │      │  Token rewards   │
└─────────────────┘      └──────────────────┘      └─────────────────┘

Key security feature: HMAC signing keys and API secrets stay on your server. The browser never sees them. Scores are cryptographically verified to prevent cheating.

Open Source Repositories

🔧 Developer Tools

Repository Description
game-sdk TypeScript SDK — auth, sessions, scoring, leaderboards npm
create-gamvio-game CLI scaffolding — npx create-gamvio-game npm

🎮 Sample Projects

Repository Games Description
sample-arcade Gravity Flip · Neon Racer · Pixel Runner · Rhythm Tap · Asteroid Miner Action & arcade games with SDK integration
sample-strategy Tower Defense · Shadow Chess · Infection · Merge Lab · Portal Maze Strategy & puzzle games with SDK integration

Platform Architecture

                    ┌─────────────────────────────────────┐
                    │           gamv.io (Cloudflare)       │
                    └───────────┬─────────────────────────┘
                                │
                    ┌───────────┼───────────────┐
                    │           │               │
              ┌─────▼─────┐ ┌──▼──────┐ ┌──────▼──────┐
              │  Web App   │ │ Dev     │ │  Admin      │
              │  Next.js   │ │ Portal  │ │  Dashboard  │
              │  :4000     │ │ :4001   │ │  :4002      │
              └─────┬──────┘ └──┬──────┘ └──────┬──────┘
                    │           │               │
              ┌─────▼───────────▼───────────────▼──────┐
              │           Go API (Fiber) :8080          │
              │                                         │
              │  Auth · Games · Sessions · Leaderboard  │
              │  Tokens · Quests · SDK · Admin           │
              └──────────┬──────────────┬──────────────┘
                         │              │
                  ┌──────▼──────┐ ┌─────▼─────┐
                  │ PostgreSQL  │ │   Redis    │
                  │    :5433    │ │   :6379    │
                  └─────────────┘ └───────────┘

Tech Stack

Layer Technology
Frontend Next.js 15 · React 19 · Tailwind CSS 4 · TypeScript
Backend Go 1.22 · Fiber v2 · PostgreSQL 16 · Redis 7
Auth NextAuth v5 · Google OAuth · Kakao OAuth
Blockchain Xphere (EVM-compatible) · Thirdweb SDK
Game SDK TypeScript · HMAC-SHA256 · Server Actions
Infrastructure Ubuntu · Nginx · PM2 · Docker · Cloudflare

SDK Features

Feature Description
Session Management Start/end game sessions with server-generated HMAC keys
Score Submission Cryptographically signed scores — tamper-proof
Leaderboards Global and weekly rankings, player rank lookup
Player Auth Email/password or wallet login via SDK API keys
Token Rewards Automatic POINT distribution based on score thresholds
Test Mode POST /sdk/auth/test-token — instant dev tokens with API key only
Multi-Game One project can host multiple games with dynamic gameId

Game Categories

Category Count Examples
🕹️ Arcade 15+ Tetris, Snake, Flappy Jump, Space Invaders, Breakout
🧩 Puzzle 12+ 2048, Sudoku, Minesweeper, Hex Puzzle, Pipe Connect
♟️ Strategy 8+ Tower Defense, Shadow Chess, Infection, Reversi
🎲 Board 10+ Go-Stop, Baduk, Omok, Chess, Janggi, Yut-Nori
🃏 Card 8+ Texas Hold'em, Seotda, Badugi, One Card, Seven Poker
🧠 Brain 6+ Math Sprint, Word Scramble, Crossword, Typing Race
🎯 Casual 10+ Bubble Shooter, Merge Lab, Color Match, Tower Stack
💰 Crypto 1 Crypto Predict (real-time OraXL oracle data)

Links
🌐 Platform gamv.io
🔧 Developer Portal dev.gamv.io
📖 SDK Documentation gamv.io/developers/docs
📡 API Reference gamv.io/developers/api
📦 npm Package @gamvio/game-sdk
🛡️ Admin Dashboard admin.gamv.io

Built in Seoul 🇰🇷

Play Games · Build Games · Get SDK Keys

Popular repositories Loading

  1. game-sdk game-sdk Public

    Gamvio Game SDK - Integrate your game with the Gamvio platform

    TypeScript

  2. create-gamvio-game create-gamvio-game Public

    Create a new game for the Gamvio platform — npx create-gamvio-game my-game

    TypeScript

  3. sample-arcade sample-arcade Public

    Sample arcade games built with @gamvio/game-sdk — Gravity Flip, Neon Racer, Pixel Runner, Rhythm Tap, Asteroid Miner

    TypeScript

  4. sample-strategy sample-strategy Public

    Sample strategy & puzzle games built with @gamvio/game-sdk — Tower Defense, Shadow Chess, Infection, Merge Lab, Portal Maze

    TypeScript

  5. .github .github Public

    Gamvio organization profile

Repositories

Showing 5 of 5 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…