🚀 Web Challenges Repository

Transform your web development skills through hands-on challenges!

Welcome to the Web Sub-Section Challenges repository! This space is designed to help you master both Frontend and Backend development through practical coding exercises that follow each Web Workshop. Plus, you'll become a Git & GitHub expert along the way! 🧠✨

---

🏗️ Repository Architecture

web-challenges/
│
├── 🎨 frontend/
│   ├── 🎯 challenge-01/
│   │   ├── 📝 starter/ ─────────── Your playground
│   │   └── 🔐 solution/ ───────── Unlocked after deadline
│   ├── 🎯 challenge-02/
│   └── ...
│
├── ⚡ backend/
│   ├── 🎯 challenge-01/
│   │   ├── 📝 starter/ ─────────── Your playground
│   │   └── 🔐 solution/ ───────── Unlocked after deadline
│   ├── 🎯 challenge-02/
│   └── ...
│
├── 📖 README.md
└── 🤝 CONTRIBUTING.md

💡 Pro Tip: Each challenge includes a starter/ folder where you'll build your solution.
The solution/ folder becomes visible after the deadline for learning purposes.

---

🎯 What You'll Achieve

This repository will help you:

• 💡 Apply workshop knowledge through real-world challenges
• 💻 Sharpen your coding skills with bite-sized, practical projects
• 🌱 Master Git + GitHub workflows like a professional developer
• 🤝 Experience team collaboration through Pull Requests and code reviews

---

⚡ Your Challenge Journey

🔄 How It Works

1. 🔔 Challenge Announcement → You'll get notified on Discord

2. 🎯 Choose Your Path → Navigate to your track (frontend/backend)

3. 📋 Follow the Guide → Check CONTRIBUTING.md for detailed steps:

   • 🍴 Fork this repository
   • 💻 Solve the challenge in your environment
   • 🚀 Push your creative solution
   • 📤 Submit your Pull Request

---

⚙️ Lightning-Fast Setup

Setup has been streamlined for you! Each challenge's starter/ folder includes a custom setup.js script that works seamlessly across all platforms:

# Navigate to your challenge
cd starter

# One command to rule them all ✨
npm run setup

🎉 That's it! The script handles package installation and dev server startup automatically.

---

💬 Get Support & Connect

Stuck on a challenge? Have questions? You're encouraged to:

• 🗣️ Start a conversation in Discussions
• 🐛 Report issues or request features via Issues

Your questions help build a stronger learning community for everyone! 🌟

---

🏷️ Labeling System

To keep things organized, these labels are used on Pull Requests:

• 🎨 frontend / ⚡ backend → Track identification
• 🎯 challenge-01, challenge-02, ... → Challenge numbering

---

⚠️ Repository Guidelines

To maintain code quality and learning integrity:

• ❌ Never modify the solution/ folder
• ❌ Never push directly to main — always work on your forked branch
• ✅ Always follow the contribution workflow outlined

---

🎬 Ready to Level Up?

👈 Your next step: Head to CONTRIBUTING.md

You'll find a beginner-friendly guide that walks you through everything step-by-step!

---

Happy coding, and let's build something amazing together! 💙

— Adel | Creator of Web Challenges