https://github.com/camilo6castell/elbingogranbuda-frontend

[EN][please see README.md] Este proyecto se encarga de la parte interacción con los usuarios por medio de una moderna interfaz gráfica de la aplicación del Bingo Gran Buda.
https://github.com/camilo6castell/elbingogranbuda-frontend

next-js react-js styled-components

Last synced: 6 months ago
JSON representation

[EN][please see README.md] Este proyecto se encarga de la parte interacción con los usuarios por medio de una moderna interfaz gráfica de la aplicación del Bingo Gran Buda.

• Host: GitHub
• URL: https://github.com/camilo6castell/elbingogranbuda-frontend
• Owner: camilo6castell
• Created: 2024-02-21T03:11:13.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-08-06T03:44:17.000Z (almost 2 years ago)
• Last Synced: 2025-04-07T12:15:38.299Z (over 1 year ago)
• Topics: next-js, react-js, styled-components
• Language: JavaScript
• Homepage: https://el-bingo-gran-buda-frontend.vercel.app
• Size: 229 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
Frontend (Next.js)

│

├── app/

│   ├── (routes)

│   └── layout.jsx

│

├── components/        ← UI pura (sin lógica de red)

│

├── services/          ← HTTP + Socket.IO

│   ├── api/

│   └── sockets/

│

├── store/             ← Estado global del juego

│

├── hooks/             ← Hooks reutilizables

│

├── domain/            ← Reglas del frontend (sí, también aplica)

│

└── config/            ← env, endpoints

******

Sockets NO deciden lógica

Store NO decide reglas

Domain (BingoEngine) decide si hay ganador

Hooks orquestan

*****

🧠 Responsabilidades (muy importante)

Capa	Hace qué

Store	Guarda estado

Socket	Comunica

Domain (BingoEngine)	Reglas del bingo

useGameEngine	Orquesta todo

*******

# elBingoGranBuda: Frontend

![React](https://img.shields.io/badge/React-61DAFB?style=for-the-badge&logo=react&logoColor=black)

![Next.js](https://img.shields.io/badge/Next.js-000000?style=for-the-badge&logo=nextdotjs&logoColor=white)

![Styled-Components](https://img.shields.io/badge/Styled--Components-DB7093?style=for-the-badge&logo=styled-components&logoColor=white)

## About

This project is the frontend of the elBingoGranBuda web application, developed using **React.js** and **Next.js**. It provides an interactive interface for users to play bingo online, featuring real-time updates and a modern design.

## Features

1. User Authentication: Secure login and registration.

2. Real-time Bingo Game: Interactive bingo game with real-time updates.

3. User Profile: Manage user information and game history.

4. Responsive Design: Optimized for both desktop and mobile devices.

5. Styled Components: Customizable and modular CSS using styled-components.

## Installation

To set up the project locally, follow these steps:

1. **Clone the repository:**

   ```bash

   git clone https://github.com/camilo6castell/elBingoGranBuda-Frontend.git

   cd elBingoGranBuda-Frontend

   ```

2. **Install dependencies:**

   ```bash

   npm install

   ```

3. **Run the development server:**

   ```bash

   npm run dev

   ```

   Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.

## Scripts

- **`dev`**: Starts the development server.

- **`build`**: Builds the application for production.

- **`start`**: Starts the production server.

- **`lint`**: Runs ESLint to check for linting errors.

## Contact

[GitHub](https://github.com/camilo6castell?tab=repositories)

[LinkedIn](https://www.linkedin.com/in/camilocastell/)