👋 Welcome to the ESP32 Distance Sensor Workshop

Ready to get hands-on with embedded development? This workshop is designed to get you coding on real hardware in just 5 minutes—no complicated setup, no frustration!

If you have a private GitHub account and the required hardware on your desk, you can:

1. Fork this project
2. Create a new Codespace (just a few clicks)
3. Wait ~5 minutes for setup (all tools & dependencies are installed automatically)
4. Activate the ESP-IDF Web plugin in your codespace (required for direct target connection)
5. Start coding and flashing your ESP32—you're productive immediately!

It's really that easy: From zero to coding on real hardware in minutes. No local installs, no driver hassle, no toolchain pain.

---

🚦 How to get started

All you need is:

• A GitHub account (free or Pro)
• The required hardware (see hardware setup)
• A supported browser (see prerequisites)

Then follow our Getting Started Guide for step-by-step instructions!

---

💡 What you'll learn

• Modern embedded development with ESP32, FreeRTOS, and ESP-IDF
• Using GitHub Codespaces for instant cloud-based dev environments
• Leveraging Copilot and coding agents for rapid prototyping
• Building, flashing, and debugging on emulation and real hardware—no prior experience required!

---

🛠️ Workshop Materials

All exercises, guides, and resources are in this folder (or at least that's the idea). If you get stuck, ask questions, open an issue, or join the discussion. This is a friendly space for makers, learners, and tinkerers of all levels.

Have fun, experiment, and happy coding! 🎉

Tips

• Use GitHub Copilot and Copilot Chat to help with code suggestions, explanations, and troubleshooting as you work through the tasks.