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: 2 months 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 (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-12T10:42:24.000Z (10 months ago)
- Last Synced: 2025-04-09T01:51:22.751Z (8 months ago)
- Topics: amplify, aws, aws-cdk, game-development, nextjs, react, serverless, typescript, v0
- Language: TypeScript
- Homepage:
- Size: 1.09 MB
- Stars: 5
- Watchers: 7
- Forks: 2
- Open Issues: 3
-
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
## 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
- **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
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.