CodeQuest 🚀

An interactive web-based guide designed to help absolute beginners learn to code. CodeQuest provides a clear, step-by-step roadmap from knowing nothing to building your first project.

🌟 Features

• Interactive Path Selection: Choose between Web Development and Python based on your interests
• Personalized Recommendations: Get tailored learning advice based on your preferences
• 3-Month Roadmaps: Detailed learning plans for both Web Development and Python paths
• Learning Methodology: Proven strategies that actually work for coding beginners
• Curated Resources: Hand-picked YouTube channels and tutorials
• Responsive Design: Works seamlessly on desktop and mobile devices
• Smooth Navigation: Single-page application with smooth scrolling

🎯 Who Is This For?

CodeQuest is perfect for:

• Complete beginners who have never written a line of code
• People overwhelmed by the vast amount of programming resources online
• Self-learners who want a structured approach to coding
• Anyone looking for a clear roadmap to start their programming journey

🚀 Getting Started

Prerequisites

No programming knowledge required! Just a web browser and motivation to learn.

Running the Application

1. Clone the repository:

   git clone https://github.com/Alish-0x/codequest.git
   cd codequest

2. Open in your browser: Simply open the index.html file in any modern web browser, or serve it using a local server:

   # Using Python 3
   python3 -m http.server 8000
   
   # Using Python 2
   python -m SimpleHTTPServer 8000
   
   # Using Node.js (if you have npx)
   npx serve .

3. Visit the application: Open your browser and go to http://localhost:8000

🎨 Technology Stack

• HTML5: Semantic markup and structure
• CSS3: Custom styles and animations
• JavaScript: Interactive functionality and dynamic content
• Tailwind CSS: Utility-first CSS framework for responsive design
• Google Fonts: Inter font family for clean typography

📚 How It Works

1. Choose Your Path: Select between "Building & Designing" (Web Development) or "Logic & Data" (Python)
2. Get Personalized Recommendations: Receive tailored advice based on your choice
3. Follow the Roadmap: Use the 3-month learning plan specific to your chosen path
4. Apply Learning Methods: Follow proven strategies that work for beginners
5. Use Curated Resources: Access hand-picked YouTube channels and tutorials
6. Plan Next Steps: Understand what to learn after the initial 3 months

🗺️ Learning Paths

Web Development Path

• Month 1: HTML, CSS, and basic JavaScript
• Month 2: Interactive JavaScript and DOM manipulation
• Month 3: Complex projects and introduction to frameworks

Python Path

• Month 1: Python syntax, data types, and basic programming concepts
• Month 2: Object-oriented programming and working with libraries
• Month 3: Specialized applications (web development, data analysis, or automation)

🤝 Contributing

We welcome contributions to make CodeQuest even better! Here's how you can help:

Types of Contributions

• Fix typos or improve content clarity
• Add new learning resources
• Improve the design or user experience
• Add new features or functionality
• Update roadmaps with current best practices

How to Contribute

1. Fork the repository
2. Create a new branch for your feature: git checkout -b feature-name
3. Make your changes
4. Test your changes by opening index.html in a browser
5. Commit your changes: git commit -m "Add feature description"
6. Push to your branch: git push origin feature-name
7. Open a Pull Request

Development Guidelines

• Keep the design clean and beginner-friendly
• Ensure all content is accessible to complete beginners
• Test on both desktop and mobile devices
• Follow the existing code style and structure
• Add comments for any complex JavaScript functionality

📖 Project Structure

codequest/
├── index.html          # Main application file
├── README.md           # Project documentation
└── .git/              # Git repository data

🌈 Design Philosophy

CodeQuest follows these core principles:

• Beginner-First: Every decision prioritizes the absolute beginner's experience
• Choice, Not Overwhelm: Provide clear paths instead of endless options
• Interactive Learning: Engage users actively rather than passive consumption
• Real-World Focus: Emphasize practical skills over theoretical knowledge
• Encouraging Tone: Maintain a supportive, motivating voice throughout

📱 Browser Support

CodeQuest works on all modern browsers including:

• Chrome 60+
• Firefox 60+
• Safari 12+
• Edge 79+

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

• Thanks to all the amazing educators who inspired this guide
• Tailwind CSS for making responsive design effortless
• The coding community for sharing knowledge freely
• All the beginners who inspired us to create a better learning experience

📞 Support

If you have questions or need help:

• Open an issue on GitHub
• Check the interactive guide for learning resources
• Follow the recommended YouTube channels for additional help

---

Ready to start your coding journey? Open the application and take the first step! 🎉