Welcome to the Satsurge project!
Live Demo/Homepage | GitHub Repo

Satsurge is an arcade-style, bitcoin-native play-to-earn app that allows players to earn real bitcoin rewards for their in-game achievements. The project is built with modern web technologies (primarily TypeScript) and is designed for both players and creators in the growing online gaming and creator economy. Satsurge integrates with the Bitcoin Lightning Network for instant, low-fee transactions, making it a pioneer in web-based, play-to-earn arcade gaming.

• Play-to-Earn: Earn bitcoin (sats) through arcade gameplay and competitions.
• Bitcoin Lightning Integration: Fast, secure, and low-fee transactions for payouts and rewards.
• Creator Economy: Dashboards and tools for game creators to design and monetize experiences.
• Modern Web Stack: Built with TypeScript, Vite, Tailwind CSS, and React.
• Open Source: Licensed under MIT for community contributions and transparency.

The codebase is organized for scalability and clarity:

• index.html — Application entry point.
• package.json / package-lock.json — Project dependencies and scripts.
• vite.config.ts, tailwind.config.js, postcss.config.js — Build and styling tool configurations.
• public/ — Static assets served directly.

• App Entry & Styles

  • App.tsx, App.css, main.tsx, index.css, vite-env.d.ts

• Core Subdirectories:

  • assets/ — Game/media assets.
  • components/ — UI and functional components:
    • GameEditor.tsx: Visual game editor for custom levels/games.
    • GameTemplateModal.tsx: Modal for selecting/using templates.
    • ScrollToTop.tsx: UX utility.
    • Sidebar.tsx: Navigation/sidebar UI.
    • TournamentModal.tsx: Tournament management UI.
  • contexts/ — Global state/logic providers:
    • AuthContext.tsx: Handles user authentication and session logic.
  • pages/ — Major app pages/routes:
    • AboutPage.tsx
    • AuthPage.tsx
    • CreatorDashboard.tsx
    • Documentation.tsx
    • HelpPage.tsx
    • HomePage.tsx
    • NotFoundPage.tsx
    • PlayerDashboard.tsx
    • RoomPage.tsx
    • StatusPage.tsx
  • utils/ — Utilities and backend integration:
    • blocklyConfig.ts: Configuration for drag-and-drop game dev.
    • dbTournamentService.ts: Tournament data management.
    • gameService.ts: Core game logic/services.
    • lightningPayments.ts: Lightning Network integration.
    • phaserEngine.ts: Game engine abstraction (Phaser).
    • supabase.ts: Backend-as-a-service integration.
    • tournamentService.ts: Tournament operations.

• Deliver a true play-to-earn experience, rewarding players in bitcoin.
• Empower creators to design, share, and monetize new arcade experiences.
• Use cutting-edge web tech (React, TypeScript, Vite, Tailwind, Supabase) for speed, scalability, and user experience.
• Build a transparent, community-driven, and open source project.

1. Clone & Install:

   git clone https://github.com/axelvyrn/Satsurge.git
   cd Satsurge
   npm install

2. Run the App:

   npm run dev

3. Visit http://localhost:5173

• Read the LICENSE for guidelines.
• Issues and PRs are welcome—help shape the future of bitcoin-native gaming!

Satsurge is in active development. Join the community and help build the future of play-to-earn arcade gaming!