Add comprehensive end-to-end demo project with documentation and tools

[Copilot]

Resolves #2 by providing a complete end-to-end coding demo project that demonstrates how to use codesandbox-mcp with AI agents.

What's Added

📁 Complete Demo Project Structure

• /examples/ - Main examples directory with overview and navigation
• /examples/quick-start/ - Comprehensive tutorial covering setup through advanced usage
• /examples/quick-start/configs/ - Ready-to-use MCP client configurations

📚 Comprehensive Documentation (10 files, ~40KB)

• Quick Start Guide - Step-by-step setup for Claude Desktop, Cursor, and custom MCP clients
• Interactive Demo - Copy-paste commands users can run immediately to test their setup
• Sample Workflows - 8 real-world scenarios including full-stack development, code review, testing, and migration
• Troubleshooting Guide - Common issues, solutions, and debugging steps
• Advanced Usage - Enterprise features, performance optimization, and complex integrations

🛠️ Practical Tools

• Setup Validator (validate-setup.js) - Automated script that checks Node.js version, API token, configuration, and connectivity
• Configuration Templates - Pre-configured JSON files for different MCP clients with proper environment variable setup

🎯 Real-World Examples

The demo includes practical AI prompts for:

• Creating React TypeScript sandboxes with complete project structure
• Setting up full-stack applications with frontend/backend separation
• Code review and refactoring workflows
• API documentation generation
• Testing environment setup with Jest and Cypress
• Performance optimization and bundle analysis
• Migration from local projects to CodeSandbox
• Collaborative development with multiple sessions

Key Features

Immediate Usability: Users can copy configuration files and AI prompts directly from the documentation to start using codesandbox-mcp right away.

Progressive Learning: Documentation is structured from basic setup to advanced enterprise features, accommodating users at all experience levels.

Troubleshooting Support: Comprehensive troubleshooting guide addresses common authentication, connection, and configuration issues with specific solutions.

Validation Tools: Automated setup validator helps users identify and fix configuration problems before they start development.

Updated Main README

Enhanced the main README with clear navigation to the demo project and examples, making it easy for new users to find comprehensive tutorials and for existing users to access advanced documentation.

This addresses the core request in issue #2 by providing not just basic examples, but a complete learning resource that demonstrates the full potential of codesandbox-mcp in real development workflows.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• api.codesandbox.io
  • Triggering command: curl -I -s --max-time 10 REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[carloslibardo]

@codex review

[carloslibardo]

@cursor review

[cursor]

Skipping Bugbot: Bugbot is disabled for this repository

[chatgpt-codex-connector]

Codex Review: Didn't find any major issues. Breezy!

About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you open a pull request for review, mark a draft as ready, or comment "@codex review". If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex fix this CI failure" or "@codex address that feedback".

[carloslibardo]

@codex ensure demo implementation is correct, check best possible approachs

[chatgpt-codex-connector]

    > [!NOTE]
    > > @codex ensure demo implementation is correct, check best possible approachs

For now, I can only help with PRs you've created.