Implement Laravel-style documentation website with VitePress

[Copilot]

This PR implements a comprehensive, modern documentation website for the OZone Framework using VitePress, following Laravel's documentation style and structure.

Overview

The OZone Framework now has a professional documentation website that provides:

• Modern Design: Clean, responsive interface with dark/light mode toggle
• Comprehensive Coverage: Installation guides, tutorials, API reference, and examples
• Developer Experience: Hot reload development server, optimized builds, and automated deployment

What's New

Documentation Structure

• Homepage: Hero section showcasing OZone's key features and benefits
• Getting Started Guide: Step-by-step installation and configuration instructions
• Core Concepts: Detailed tutorials covering routing, controllers, views, and API documentation
• API Reference: Complete documentation for core classes and REST API components
• Examples: Practical code samples and usage patterns

Technical Features

• VitePress Integration: Modern static site generator with Vue.js components
• Responsive Design: Works seamlessly across desktop, tablet, and mobile devices
• Search & Navigation: Intuitive sidebar navigation with table of contents
• Syntax Highlighting: Beautiful code highlighting for PHP examples
• Cross-References: Internal linking between documentation sections

Development Workflow

# Start development server with hot reload
npm run docs:dev

# Build optimized static site
npm run docs:build

# Preview production build
npm run docs:preview

Automated Deployment

GitHub Actions workflow automatically deploys the documentation to GitHub Pages when changes are pushed to the main branch.

Screenshot

The new documentation homepage showcases OZone's capabilities with a clean, professional design that matches the quality of Laravel's documentation.

Files Added

• docs/ - Complete documentation structure with VitePress configuration
• .github/workflows/docs.yml - Automated deployment workflow
• Root package.json - Project-level npm scripts for documentation
• Updated .gitignore - Excludes documentation build artifacts

This implementation provides the OZone Framework with a professional documentation presence that will significantly improve the developer experience and help drive adoption.

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:

• https://api.github.com/repos/symfony/deprecation-contracts/zipball/63afe740e99a13ba87ec199bb07bbdee937a5b62
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/nlhg6n /usr/bin/composer install --no-dev --optimize-autoloader (http block)
• https://api.github.com/repos/symfony/polyfill-ctype/zipball/a3cc8b044a6ea513310cbd48ef7333b384945638
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/nlhg6n /usr/bin/composer install --no-dev --optimize-autoloader (http block)
• https://api.github.com/repos/symfony/polyfill-mbstring/zipball/6d857f4d76bd4b343eac26d6b539585d2bc56493
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/nlhg6n /usr/bin/composer install --no-dev --optimize-autoloader (http block)
• https://api.github.com/repos/thephpleague/color-extractor/zipball/837086ec60f50c84c611c613963e4ad2e2aec806
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/nlhg6n /usr/bin/composer install --no-dev --optimize-autoloader (http block)
• https://api.github.com/repos/webmozarts/assert/zipball/11cb2199493b2f8a3b53e7f19068fc6aac760991
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/nlhg6n /usr/bin/composer install --no-dev --optimize-autoloader (http 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)

Original prompt

Make the repository ready for a Laravel style documentation website

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.