README

⚡ A modular, async-first PHP framework with native reactive UI and enterprise-grade performance

Hurricane is a modern, high-performance PHP framework ecosystem designed for developers who want to build fast, secure, and scalable applications without the overhead of traditional monolithic frameworks.

It combines a modular backend architecture, Fiber-powered async capabilities, and a server-driven reactive UI layer, enabling you to create everything from portfolio websites and dashboards to API-driven applications with minimal complexity and maximum efficiency.

🧠 Philosophy

Hurricane is built on a simple principle:

Keep the core minimal, make everything modular, and optimize for real-world performance.

• No unnecessary abstractions
• No heavy bootstrapping
• No forced complexity

Instead, Hurricane provides a clean, extensible foundation where each feature is delivered through independent, PSR-compliant packages.

⚙️ Architecture Overview

Hurricane follows a package-driven architecture, where each component is designed as a standalone Composer package:

• Core kernel & lifecycle management
• PSR-compliant HTTP layer (Request, Response, Middleware)
• High-performance routing with caching
• Dependency Injection (PSR-11 container)
• Validation, security, and database layers
• Async I/O engine powered by PHP Fibers
• Reactive UI system with minimal JavaScript

This structure ensures flexibility, maintainability, and long-term scalability.

🚀 Key Capabilities

⚡ High Performance by Design

• Optimized routing with compiled caching
• Minimal kernel overhead
• OPcache-friendly architecture
• Lazy-loaded services and components

🔄 Async-First Execution

• Parallel API requests using Fiber-based concurrency
• Non-blocking I/O for external services
• Ideal for API-heavy and real-time applications

🔐 Security by Default

• Built-in CSRF and XSS protection
• Secure session handling and encryption (Sodium)
• Rate limiting and brute-force protection
• Strict use of prepared statements (PDO)

🧩 Modular Ecosystem

• Independent packages for routing, database, auth, caching, and more
• PSR-compliant (PSR-4, 7, 11, 15, 18, etc.)
• Easily extendable and replaceable components

🎨 Native Reactive UI (Hurricane UI)

• Server-driven components with PHP
• Async rendering without page reloads
• Minimal JavaScript runtime
• SEO-friendly server-side rendering

🗄️ Database & API Ready

• PDO-based query builder
• Support for SQLite, MySQL, PostgreSQL, and more
• Built-in API authentication system (token-based)
• Optimized queries with indexing strategies

🧑‍💻 Developer Experience

Hurricane is designed to provide a clean and efficient development workflow:

• Simple project scaffolding via Composer
• Built-in CLI tools for rapid development
• Clear folder structure and conventions
• Strong typing and modern PHP features (8.2+)

🎯 Use Cases

Hurricane is ideal for:

• Portfolio websites and personal projects
• Admin dashboards and CRUD applications
• API aggregation platforms
• Lightweight SaaS products
• Headless backend services

🌪️ Final Thought

Hurricane is not just a framework—it’s a modern PHP ecosystem that blends:

Performance + Modularity + Async Power + Simplicity

Build faster, stay secure, and scale confidently—without the weight of traditional frameworks.