Skip to content

Commit

Permalink
added readme
Browse files Browse the repository at this point in the history
  • Loading branch information
akshithere committed Sep 15, 2024
1 parent 67a7133 commit bc76bca
Showing 1 changed file with 93 additions and 45 deletions.
138 changes: 93 additions & 45 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,47 +1,95 @@
# PokeArcadia
Welcome to PokeArcadia, a pixel-perfect paradise where your favorite classic Pokémon roam free. Add your Pokémon, watch them thrive, and enjoy a lighthearted experience!
# PokeArcadia: A Fun Way to Learn GitHub Workflow!

Welcome to **PokeArcadia**! 🎉 This project is designed to help kids learn the basics of GitHub workflow through a fun and engaging game. You'll learn how to use GitHub features like push, pull, and more while working on a cool project.

## Table of Contents

- [Introduction](#introduction)
- [Project Structure](#project-structure)
- [How to Contribute](#how-to-contribute)
- [File Format](#file-format)
- [Getting Started](#getting-started)
- [Contributing](#contributing)
- [Licenses](#licenses)

## Introduction

PokeArcadia is a fun game where you get to work with a Pokémon-themed project. The project is divided into two main parts: the frontend and the backend. You'll be adding data to the backend, and your changes will be reflected in the frontend. Along the way, you'll get hands-on experience with GitHub by learning how to make changes, push them to GitHub, and collaborate with others.

## Project Structure

Here's a quick overview of the project structure:

PokeArcadia/
│ ├── frontend/
# The frontend of the game
│ ├── backend/ # The backend where you will make your changes
│ └── Entries/ # The folder where you will add your .txt files
│ └── README.md # This file!

## How to Contribute

To contribute to PokeArcadia, you'll be adding your own .txt file to the `backend/Entries/` folder. Follow the instructions below to get started.

## File Format

When you add a new `.txt` file to the `backend/Entries/` folder, make sure it follows this format:

PokeID, YourName
# examples ->
-25, Akshit
-36, Swati


This file format is used to record the Pokémon ID and the name of the contributor.

## Getting Started
To set up the project, follow these steps:

## 1. Clone the Repository

```
git clone <repository-url>
cd PokeArcadia
```

## 2. Install Dependencies
Navigate to the frontend and backend directories to install the required dependencies.
```
# Frontend setup
cd frontend
npm install
# Backend setup
cd ../backend
npm install
npm install cors
# Navigate back to the root directory
cd ..
```
## Running the Application
### Frontend
To start the frontend server, run:
```
npm run dev
```
### Backend
To build and run the backend server:
```
npm run build
```

## Optional: Generate Sample Data
You can generate sample test files by navigating to the `/backend/Entries` directory and running the `generate.py` script. You will be prompted to specify the number of entries you'd like to generate.
```
python3 generate.py
```

Here’s a step-by-step guide to get started with PokeArcadia and learn GitHub workflow:

1. **Fork the Repository:**
- Go to the [PokeArcadia GitHub page](#) and click the "Fork" button to create your own copy of the repository.

2. **Clone Your Fork:**
- Clone your forked repository to your local machine using Git:
```bash
git clone https://github.com/your-username/PokeArcadia.git
```

3. **Navigate to the Backend Folder:**
- Go to the `backend/Entries/` folder:
```bash
cd PokeArcadia/backend/Entries
```

4. **Add Your File:**
- Create a new `.txt` file with the required format and add it to the `Entries` folder.

5. **Stage Your Changes:**
- Add the file to the staging area:
```bash
git add your-file.txt
```

6. **Commit Your Changes:**
- Commit the changes with a meaningful message:
```bash
git commit -m "Added new Pokémon entry for [Your Name]"
```

7. **Push Your Changes:**
- Push the changes to your forked repository:
```bash
git push origin main
```

8. **Create a Pull Request:**
- Go to the PokeArcadia GitHub page and create a pull request to merge your changes from your forked repository to the original repository.


---

Have fun contributing to PokeArcadia and learning GitHub workflow! 🌟 If you have any questions, don’t hesitate to reach out to us. Happy Open Sorcering! 🚀


0 comments on commit bc76bca

Please sign in to comment.