Skip to content

msokay/GoSocial

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation

GoSocial ⚪⚫

The Duolingo for Weiqi (Go).

GoSocial is a web-based social platform designed to democratize the ancient game of Weiqi (Go). It combines bite-sized, gamified learning with daily turn-based engagement to help new Western players break into the game and build a daily habit.

image

🚀 Features

🥋 The Dojo (Learning Track)

A gamified, linear progression path for beginners.

  • Interactive Lessons: Learn liberties, connection, cutting, and life & death.
  • Rule Validation: Real-time feedback prevents illegal moves.
  • XP Rewards: Earn experience for mastering concepts.

🧩 Puzzle Arena

Twisting your brain with daily tactical challenges.

  • Daily Puzzles: A fresh challenge every day.
  • Content Multiplier: Puzzles are randomly rotated or color-swapped to ensure variety.
  • Streak System: Solve daily to keep your flame alive!

🤖 Play vs Bot

Practice without pressure.

  • Multiple Personalities: Challenge "Cautious Cal" (Defensive) or "Aggressive Al" (Combat-heavy).
  • 9x9 Board: Perfect for quick games.
  • Combat XP: Earn XP for every stone you capture.

🏆 Leagues & Gamification

  • Weekly Leaderboards: Compete with others for promotion.
  • Tiers: Climb from Stone to Master rank.
  • Stats: Track your streak and total experience.

🛠️ Tech Stack

  • Frontend: React, TypeScript, Vite
  • Styling: Tailwind CSS, Lucide Icons
  • Game Engine: Custom TypeScript implementation
  • State Management: React Context + LocalStorage (MVP)

🏃‍♂️ Getting Started

  1. Clone the repository

    git clone https://github.com/msokay/GoSocial.git
    cd GoSocial
  2. Install Dependencies

    cd frontend
    npm install
  3. Run the App

    npm run dev

    Open http://localhost:5173 to view it in your browser.

🤝 Contributing

This is an MVP (Minimum Viable Product). Contributions are welcome!

  • Roadmap: 13x13/19x19 boards, Real-time multiplayer, Backend integration (Postgres/Redis).

📄 License

MIT License.

About

A weiqi/go social learning platform

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages