Download the PHP package saeedvir/laravel-project-markdown without Composer
On this page you can find all versions of the php package saeedvir/laravel-project-markdown. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download saeedvir/laravel-project-markdown
More information about saeedvir/laravel-project-markdown
Files in saeedvir/laravel-project-markdown
Package laravel-project-markdown
Short Description Laravel package to generate comprehensive markdown documentation for project files and database schema with AI-readable output
License MIT
Homepage https://github.com/saeedvir/laravel-project-markdown
Informations about the package laravel-project-markdown
Laravel Project Markdown
A comprehensive Laravel package that provides artisan commands to generate detailed markdown documentation for your project files and database schema. Perfect for developers, teams, and AI systems that need to understand your Laravel project structure.
๐ Features
๐ Project Files Documentation
- Complete Project Structure: Generate hierarchical tree view of your entire project
- File Metadata: Size, modification dates, and file types
- Package Discovery: Automatically detect Laravel packages and their providers/aliases
- Version Information: Laravel, PHP, and database version detection
- Composer Analysis: Parse and display all installed packages
- Smart Filtering: Exclude unnecessary directories and files
- Dual Output: Generate both human-readable Markdown and machine-readable JSON
๐๏ธ Database Documentation
- Schema Analysis: Complete database structure documentation
- ER Diagrams: Generate Mermaid diagrams for visual database relationships
- Table Details: Columns, types, constraints, indexes, and foreign keys
- Relationship Mapping: Visual connections between tables
- Color-coded Tables: Beautiful, organized database diagrams
- Sample Data: Include sample queries for better understanding
- Multi-database Support: MySQL, PostgreSQL, and SQLite
๐ค AI Readable Documentation
- Structured JSON Output: Machine-readable format for AI systems
- Comprehensive Metadata: All project information in structured format
- API Documentation: Clear command signatures and options
- Consistent Formatting: Standardized output for AI processing
- Version Tracking: Complete version information for compatibility
๐ฆ Installation
Via Composer (Recommended)
Local Development Installation
-
Add path repository to your Laravel project's
composer.json: -
Install the package:
- Publish configuration (optional):
โ๏ธ Configuration
The package includes a comprehensive configuration file at config/laravel-project-markdown.php:
๐ฏ Usage
Project Files Documentation
Generate comprehensive documentation for your project files:
Command Options
| Option | Description | Default |
|---|---|---|
path |
Project path to analyze | base_path() |
--output |
Output markdown file path | storage/app/project-structure.md |
--exclude |
Additional directories to exclude | [] |
--depth |
Maximum directory depth | PHP_INT_MAX |
Examples
Database Documentation
Generate comprehensive database schema documentation:
Command Options
| Option | Description | Default |
|---|---|---|
--path |
Output file path | database.md |
Examples
๐ Generated Documentation
Files Documentation Output
The files documentation includes:
-
Project Overview
- Project name and type
- Generation timestamp
- Version information (Laravel, PHP, Database)
-
Composer Packages
- All installed packages with versions
- Laravel discoverable packages
- Service providers and aliases
-
Project Structure
- Hierarchical file tree
- File sizes and modification dates
- Directory organization
- JSON Metadata
- Machine-readable project information
- Complete package list
- File structure data
Database Documentation Output
The database documentation includes:
-
Database Overview
- Database name and type
- Version information
- Generation timestamp
-
ER Diagram
- Mermaid-compatible diagram
- Color-coded tables
- Relationship connections
-
Table Details
- Column specifications
- Data types and constraints
- Indexes and foreign keys
- Sample data queries
- JSON Schema
- Complete database structure
- Relationship mappings
- Metadata for AI processing
๐ค AI Readable Documentation
This package is specifically designed to generate documentation that is both human-readable and AI-processable:
Structured JSON Output
Every command generates a corresponding JSON file with structured data:
AI Processing Benefits
- Consistent Format: Standardized JSON structure for easy parsing
- Complete Metadata: All project information in one place
- Version Tracking: Clear version information for compatibility
- Relationship Data: Database relationships in structured format
- File Analysis: Complete project structure for AI understanding
Use Cases for AI Systems
- Code Analysis: AI can understand project structure and dependencies
- Documentation Generation: Automated documentation creation
- Migration Planning: Database schema analysis for migrations
- Dependency Management: Package analysis and updates
- Project Onboarding: Quick project understanding for new developers
๐ง Advanced Configuration
Custom Exclude Patterns
Database Connection Settings
The database command automatically uses your Laravel database configuration. Ensure your .env file has proper database settings:
๐ Requirements
- PHP: 8.1 or higher
- Laravel: 10.0 or higher
- Database: MySQL, PostgreSQL, or SQLite (for database documentation)
๐งช Testing
Run the test suite:
๐ Examples
Example 1: Basic Project Analysis
Example 2: Database Schema Documentation
Example 3: Custom Analysis
๐ค Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
๐ Changelog
[1.0.0] - 2025-09-20
Added
- Initial release of Laravel Project Markdown package
project:files-markdowncommand for comprehensive project analysisproject:db-markdowncommand for database schema documentation- AI-readable JSON output for both commands
- Mermaid ER diagram generation
- Laravel package discovery and analysis
- Comprehensive configuration system
- Support for Laravel 10, 11, and 12
- Support for MySQL, PostgreSQL, and SQLite databases
- File structure tree visualization
- Database relationship mapping
- Sample data generation
- Customizable exclude/include patterns
- File content previews
- Database statistics and overview
Features
- Dual Output: Both Markdown and JSON formats
- AI Integration: Structured data for AI processing
- Visual Diagrams: Mermaid-compatible ER diagrams
- Package Analysis: Complete Composer package information
- Version Detection: Automatic version information gathering
- Smart Filtering: Configurable file and directory exclusions
๐ License
This package is open-sourced software licensed under the MIT license.
๐จโ๐ป Author
Saeedvir
- Email: [email protected]
- GitHub: @saeedvir
Made with โค๏ธ for the Laravel community
All versions of laravel-project-markdown with dependencies
illuminate/support Version ^10.0|^11.0|^12.0
illuminate/console Version ^10.0|^11.0|^12.0
illuminate/database Version ^10.0|^11.0|^12.0