🎃 Midwest Pumpkins 🎃

Welcome to Midwest Pumpkins, a seasonal project perfect for October! This open-source project focuses on creating a vibrant, interactive, and fun website for showcasing everything related to pumpkins. Whether it's recipes, pumpkin farms, or Halloween decorations, this project brings the best of fall to the web.

This project is built with Vite, utilizing HTML, CSS, and JavaScript. We're proud to be participating in Hacktoberfest 2024, and we encourage the open-source community to contribute to our codebase and help us make this project great!

Watch This Video to Learn How to Contribute

🌾 Project Overview

The Midwest Pumpkins project is a fully responsive web application dedicated to celebrating the beauty and versatility of pumpkins during the fall season. This project is a collaborative effort by the OpenCode Academy team, along with contributions from other open-source enthusiasts who wanted to participate in Hacktoberfest 2024.

Key Features:

• Responsive Design: Adapts seamlessly across devices for an optimal user experience.
• Interactive Elements: Includes modals for product purchases, user reviews, and a subscription pop-up to engage visitors.
• Animated Features Section: Hover effects reveal hidden descriptions, enhancing user interaction.
• Scroll-to-Top Button: A convenient feature allowing users to easily navigate back to the top of the page.
• Theme Changer: A built-in feature for users to switch between different visual themes.
• Backend Integration: Planned functionality for receiving and managing data from pop-ups and user submissions.

Tech Stack:

• Framework: Vite
• Languages: HTML, CSS (with CSS Modules), JavaScript

Design:

Explore our creative Figma design here.

Purpose:

Our goal is to create a fun, user-friendly pumpkin-themed website that fosters community interaction while celebrating Halloween and the fall season. We welcome contributors to suggest additional features and enhancements to enrich our project further!

🎃 Hacktoberfest Participation

We’re excited to participate in Hacktoberfest 2024, an annual event where developers worldwide contribute to open-source projects! You can contribute to Midwest Pumpkins and earn a Hacktoberfest badge by adding the hacktoberfest2024 label to your pull requests.

If you’re interested in contributing, here’s how to get started:

Hacktoberfest Guidelines:

1. Sign Up for Hacktoberfest at hacktoberfest.com.
2. Make sure your pull request is labeled with hacktoberfest2024 to count towards Hacktoberfest contributions.
3. Contributions can range from code improvements to bug fixes, documentation, or even design changes!

👩‍💻 How to Contribute

We welcome contributions from both team members and the broader open-source community. Please follow the steps below to contribute to the Midwest Pumpkins project.

Steps to Contribute:

1. Fork the repository to your own GitHub account by clicking the "Fork" button at the top-right of the repository page:

   Note: For a detailed video walkthrough on how to fork and clone a repository, check out this YouTube video:

2. Clone the forked repository to your local machine:

   • Open a terminal and run the following command:

   git clone https://github.com/OpenCodeChicago/Midwest-Pumpkins.git

3. Set up the project on your local machine:

   • Navigate into the project directory

     cd Midwest-Pumpkins

   • Open the project in Visual Studio Code:

     code .

   • Install the necessary dependencies:

     npm install

   • Start the development server:

     npm run dev

4. Create a new branch for your feature or bugfix:

   git checkout -b feature/your-branch-name

   Note: Please follow the branch naming convention: feature/your-branch-name or bugfix/your-branch-name.

5. Work on your task and commit your changes:

   git add .
   git commit -m "Your meaningful commit message"

6. Push your branch to your forked repository:

   git push -u origin feature/your-branch-name

7. Create a pull request to merge your changes into the main project:

   • Go to the original repository and click "Compare & pull request."
   • Assign the pull request to Alexandrbig1 for review.
   • Use labels like hacktoberfest2024 to ensure it's counted for Hacktoberfest!

8. Wait for review. Your PR will be reviewed by the team lead, and once approved, it will be merged.

🛠 Branching Guidelines

To maintain a clean and organized project, please adhere to the following branching guidelines:

1. Use descriptive branch names that indicate the purpose of the branch.
   • Example: feature/add-pumpkin-gallery or bugfix/fix-header-alignment.
2. Create a new branch for each task you work on. Avoid making changes directly on the main branch.
3. Keep your branches up to date with the main branch by merging the latest changes from main into your feature branch regularly.
   • To sync with the latest updates from the main branch, use the following command in your feature branch:

     git pull origin main

4. Delete your branch after merging to keep the repository clean and prevent clutter. Following these guidelines will help ensure a smooth collaboration process and make it easier for everyone to contribute effectively to the Midwest Pumpkins project. Thank you for your participation!

🧰 Languages and Tools:

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🐞 Issues

If you encounter any issues or bugs while working on the Midwest Pumpkins project, please report them using the Issues section of the repository. Be sure to provide a clear description of the issue and any relevant information to help us address it promptly.

💬 Feedback

We value your input! If you have any feedback or suggestions for improving the project, please feel free to share your thoughts. You can submit feedback through the Issues section or contact us directly at opencodechicago@gmail.com

🤝 Connect With Us

Stay updated on project developments and engage with our open-source community! You can connect with us through the following platforms:

Join us to participate in discussions, share ideas, and collaborate on exciting projects. Subscribe to our YouTube channel for upcoming video tutorials and insights into open-source development!

We’d love to have you as part of our community!

🙏 Acknowledgments

A big thank you to all contributors for your hard work and dedication to the Midwest Pumpkins project. We also want to acknowledge Hacktoberfest for providing a platform to promote open-source contributions and encourage community involvement.