https://github.com/build-on-aws/fullstack-appsync-events-4-in-a-row

A fullstack real-time game where developers play four-in-a-row
https://github.com/build-on-aws/fullstack-appsync-events-4-in-a-row

amplify aws aws-cdk game-development nextjs react serverless typescript v0

Last synced: 13 days ago
JSON representation

A fullstack real-time game where developers play four-in-a-row

• Host: GitHub
• URL: https://github.com/build-on-aws/fullstack-appsync-events-4-in-a-row
• Owner: build-on-aws
• License: mit-0
• Created: 2024-11-25T16:19:35.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2024-11-26T16:10:13.000Z (3 months ago)
• Last Synced: 2024-12-17T17:40:54.869Z (about 2 months ago)
• Topics: amplify, aws, aws-cdk, game-development, nextjs, react, serverless, typescript, v0
• Language: TypeScript
• Homepage:
• Size: 592 KB
• Stars: 2
• Watchers: 6
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        

# Fullstack AppSync Events 4-in-a-Row

![gameplay](https://github.com/user-attachments/assets/6e0506c7-71d1-4586-b1ce-683e7401b828)

## Overview

Fullstack 4-in-a-Row is a real-time multiplayer game built using AWS Amplify, AWS AppSync Event API, and React. Challenge your friends to a classic connect four game with real-time updates and in-game chat functionality.

## Features

- 🎮 Real-time 4-in-a-Row gameplay

- 💬 In-game chat system

- 🔐 User authentication

- 🎟️ Game room creation and joining

- 📡 Powered by AWS AppSync Event API

## Tech Stack

![archoverview](https://github.com/user-attachments/assets/ef5fe379-4de6-4dd7-9ca8-74fb0f0312e8)

- **Frontend:** React (v0)

- **Backend:** AWS Amplify

- **Real-time Communication:** AWS AppSync Event API

- **Infrastructure:** AWS CDK

## Prerequisites

- Node.js (v18+)

- AWS Account

- AWS Amplify CLI

- npm or yarn

## Getting Started

### 1. Clone the Repository

### 2. Install Dependencies

```bash

npm install

```

### 3. Deploy Backend

```bash

npx ampx sandbox

```

## Game Mechanics

![intro-4](https://github.com/user-attachments/assets/f9b8d6ce-68c6-4872-9a66-cc04df4f256d)

1. Create a new game room

2. Share the room code with a friend

3. Take turns placing your colored discs

4. First player to connect four discs wins!

## Key Components

- 🏠 **Home Screen:** Create or join a game room

- 🎲 **Game Board:** Interactive 4-in-a-Row grid

- 💬 **Chat Interface:** Real-time messaging

- 👤 **User Management:** Authentication and profiles

**Note:** This project is a demonstration of AWS AppSync Event API capabilities and modern full-stack development practices.

## Security

See [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.

## License

This library is licensed under the MIT-0 License. See the LICENSE file.