-
Notifications
You must be signed in to change notification settings - Fork 7
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
67a7133
commit bc76bca
Showing
1 changed file
with
93 additions
and
45 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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! 🚀 | ||
|
||
|