Home

🏠 Laravel Arc Wiki

🚀 Powerful Laravel DTOs with Automatic Validation

Welcome to the comprehensive documentation for Laravel Arc

A modern Laravel package for managing Data Transfer Objects (DTOs) with automatic validation, trait-based system, and direct property access.

---

🌟 What is Laravel Arc?

Laravel Arc is a powerful Laravel package that revolutionizes how you work with Data Transfer Objects (DTOs). It provides:

• 🏗️ YAML-based DTO definitions - Define your DTOs in clean, readable YAML files
• ✅ Automatic validation - Built-in validation based on your field definitions
• 🎯 Direct property access - Access DTO properties directly without getters/setters
• 🔧 Modern trait system - Behavioral and functional traits for enhanced functionality
• ⚡ CLI generation tools - Powerful command-line tools for DTO management
• 🔄 Eloquent integration - Seamless integration with Laravel's Eloquent ORM

---

🚀 Quick Navigation

🎯 Getting Started

Perfect for newcomers to Laravel Arc

• 📖 Getting Started Guide - Installation, configuration, and your first DTO
• 💡 Examples Collection - Complete working examples and templates
• 🎓 DTO Usage Guide - How to use DTOs in your Laravel application

📚 Core Documentation

Essential guides for mastering Laravel Arc

• 📝 YAML Schema Reference - Complete YAML schema documentation
• 🏷️ Field Types Reference - All supported field types and their usage
• 🎭 Traits Guide - Complete guide to ValidatesData, ConvertsData, and DtoUtilities traits
• ✅ Validation Rules - Comprehensive validation documentation

🔧 Advanced Features

For power users and complex scenarios

• ⚡ Advanced Usage Guide - Programmatic generation, custom headers, and advanced patterns
• 🔗 Nested DTO Guide - Working with nested DTOs and circular references
• 💾 Relationships Guide - Eloquent relationships in DTOs
• 🛠️ CLI Commands - Complete command-line interface reference

🎨 Specialized Guides

Domain-specific documentation

• 🔢 Enum Custom Rules - Working with enums in DTOs
• 📦 Collection Management - Managing collections of DTOs
• 📊 Export Formats - Data export capabilities
• 🔄 Field Transformers - Data transformation options
• 🏗️ Modular Export Architecture - Advanced export patterns

🛠️ Technical References

For debugging and advanced configuration

• 🧭 DTO Path Resolver Guide - Path and namespace resolution
• 🚨 DTO Generation Exception Guide - Error handling and debugging

---

🎓 Learning Paths

👶 Beginner Path

Start here if you're new to Laravel Arc

1. 📖 Getting Started - Install and create your first DTO
2. 💡 Examples Collection - Explore basic examples
3. 🎓 DTO Usage Guide - Learn to use DTOs in controllers

👨‍💻 Intermediate Path

Ready to dive deeper?

1. 🏷️ Field Types Reference - Master all field types
2. ✅ Validation Rules - Add robust validation
3. 💾 Relationships Guide - Work with Eloquent relationships
4. 🎭 Traits Guide - Use built-in trait methods

🚀 Advanced Path

Become a Laravel Arc expert

1. ⚡ Advanced Usage Guide - Programmatic generation
2. 🔗 Nested DTO Guide - Complex nested structures
3. 🛠️ CLI Commands - Master command-line tools
4. 🚨 DTO Generation Exception Guide - Handle errors gracefully

---

🔍 Quick Reference

🎯 Need	📖 Guide	💡 Description
Quick Start	Getting Started	Installation and first DTO
Examples	Examples Collection	Working examples and templates
YAML Syntax	YAML Schema	Complete YAML schema reference
Field Types	Field Types	All supported field types
Validation	Validation Rules	Validation rules and patterns
Relationships	Relationships	Eloquent relationships
Traits	Traits Guide	Built-in trait methods
Advanced	Advanced Usage	Advanced patterns and techniques
CLI Tools	CLI Commands	Command-line interface
Troubleshooting	Exception Guide	Error handling

---

💡 Popular Use Cases

🔥 Most Common

• API Request/Response handling → DTO Usage Guide
• Form validation and processing → Validation Rules
• Data transformation and export → Field Transformers

🎯 Business Logic

• Complex nested data structures → Nested DTO Guide
• Eloquent model integration → Relationships Guide
• Collection management → Collection Management

⚡ Advanced Integration

• Programmatic DTO generation → Advanced Usage
• Custom export formats → Export Formats
• Large-scale DTO architecture → Modular Export Architecture

---

🤝 Community & Support

• � Table of Contents: Browse our organized table of contents for structured navigation
• �📋 Complete Index: Browse our complete documentation index for quick topic lookup
• 📋 Main Documentation: Complete guides and references available in this wiki
• 💡 Examples: Extensive examples collection with real-world use cases
• 🐛 Issues: Report bugs and request features on the main repository
• 💬 Discussions: Join the community discussions for questions and tips

---

🚀 Ready to get started?

📖 Start with the Getting Started Guide or explore our 💡 Examples Collection

Transform your Laravel DTOs today with Laravel Arc!