From bc76bca37f5897091a5dc975b0dd3c16a1b2f917 Mon Sep 17 00:00:00 2001 From: akshithere <130065975+akshithere@users.noreply.github.com> Date: Sun, 15 Sep 2024 19:11:54 +0530 Subject: [PATCH] added readme --- README.md | 138 ++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 93 insertions(+), 45 deletions(-) diff --git a/README.md b/README.md index 2db5af6..25ba8b2 100644 --- a/README.md +++ b/README.md @@ -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 -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! 🚀 + +