open-index/open-npm huggingface dataset:
npm package: @masewe/components
Description: [![React](https://img.shields.io/badge/React-19.1.1-blue?logo=react)](https://reactjs.org/) [![JavaScript](https://img.shields.io/badge/JavaScript-ES6-yellow?logo=javascript)](https://developer.mozilla.org/en-US/docs/Web/JavaScript) [![License](https://im
Latest version: 1.0.10

# 🟢 Gomoku Web App

[![React](https://img.shields.io/badge/React-19.1.1-blue?logo=react)](https://reactjs.org/)
[![JavaScript](https://img.shields.io/badge/JavaScript-ES6-yellow?logo=javascript)](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)

A modern web implementation of **Gomoku** (also known as Five in a Row or Gobang) built with **React**, **JavaScript**, and **Vanilla CSS**, with **Storybook** for component testing. Play this classic two-player strategy game directly in your browser!  

[🌐 Live Demo](#) 

---

## 🎮 About Gomoku

Gomoku is a two-player abstract strategy board game. Players take turns placing black or white stones on an empty grid. The objective is to be the first to form an unbroken line of five stones horizontally, vertically, or diagonally, while blocking the opponent from achieving the same.  

### How to Play

1. **Setup:** Players choose either black or white stones.  
2. **Turns:** Black places the first stone on any empty intersection.  
3. **Gameplay:** Players alternate turns, placing one stone per turn.  
4. **Winning:** The first player to form a line of five stones wins.  
5. **Draw:** The game ends in a draw if the board fills up with no winner.  

### Key Features

- **Simple Rules:** Easy to learn, suitable for all ages.  
- **Strategic Gameplay:** Encourages careful planning and foresight.  
- **Customizable Board:** Supports different grid sizes.  
- **Game Variations:** Can implement advanced rules for competitive play.  

---

## 🛠️ Tools & Technologies

- **Frontend:** React,  JavaScript, Vanilla CSS  
- **Animations:** Framer Motion  
- **Interactivity:** react-draggable  
- **Icons:** react-icons  
- **Component Testing:** Storybook  

--

## ⚡ Installation & Running Locally

1. **Clone the repository**
     ```bash
   git clone https://github.com/farah-najib/frk-24s-J-components.git
   cd gomoku-web-app ```
2. **Install dependencies**
      ```bash
   npm install
    ```
3. **Start the development server**
    ```bash
   npm run dev
    ```