📦 CocoaPods Graph

Gem Version License: MIT

Generate beautiful, interactive dependency graphs for your CocoaPods projects. Transform your Podfile.lock into stunning visualizations that help you understand complex pod relationships.

CocoaPods Graph Demo

✨ Features

  • 🎨 Interactive Dependency Wheel: Beautiful D3.js visualization with hover effects and smooth animations
  • 🔍 Smart Search: Find and highlight specific packages instantly with auto-complete dropdown
  • 📊 Detailed Statistics: Real-time stats showing total packages, direct dependencies, and relationships
  • 📱 Responsive Design: Works perfectly on desktop and mobile devices
  • 🎯 Modern UI/UX: Clean, professional interface with gradient backgrounds and smooth transitions
  • ⚡ Fast Performance: Optimized for projects with hundreds of dependencies
  • 🌐 Self-contained: Generated HTML files work offline with no external dependencies

🚀 Installation

gem install cocoapods-graph

Install from Source

git clone https://github.com/erickjung/cocoapods-graph.git
cd cocoapods-graph
bundle install
gem build cocoapods-graph.gemspec
gem install cocoapods-graph-*.gem

📖 Usage

Basic Usage

# Generate interactive HTML report
cocoapods-graph -f Podfile.lock --html

# Generate JSON data
cocoapods-graph -f Podfile.lock --json

# Print dependencies to console
cocoapods-graph -f Podfile.lock --show

# Generate both HTML and JSON
cocoapods-graph -f Podfile.lock --html --json

Command Line Options

Option Description
-f, --file FILE Specify path to Podfile.lock file
--html Generate interactive HTML dependency wheel
--json Generate JSON data file
--show Print dependencies to console
-h, --help Show help message
-v, --version Show version

Examples

# In your iOS project directory
cocoapods-graph -f Podfile.lock --html
# Creates: Podfile.lock.html

# Specify custom file path
cocoapods-graph -f MyProject/Podfile.lock --html --json
# Creates: MyProject/Podfile.lock.html and MyProject/Podfile.lock.json

# Quick dependency check
cocoapods-graph -f Podfile.lock --show

🎨 Features Showcase

Interactive Dependency Wheel

WordPress iOS App Dependencies Example dependency visualization from the WordPress iOS app, showing the interactive dependency wheel with search functionality and statistics dashboard.

📊 Try the live interactive demo! - Open the full WordPress iOS app dependency visualization

  • Hover effects: Move your mouse over any package to see its relationships
  • Visual highlighting: Related dependencies are highlighted while others fade
  • Color coding: Each package gets a unique color for easy identification
  • Smooth animations: Elegant transitions make exploration enjoyable

Smart Search Functionality

  • Live search: Results appear as you type
  • Auto-complete: Dropdown shows matching packages with dependency counts
  • One-click selection: Click any result to highlight it on the wheel
  • Keyboard navigation: Use Enter/Escape for quick actions

Professional Statistics Dashboard

  • Total Packages: Count of all pods in your project
  • Direct Dependencies: Number of pods your app directly depends on
  • Total Dependencies: Sum of all dependency relationships
  • Real-time updates: Stats update as you explore the graph

📁 Output Files

HTML Report (Podfile.lock.html)

  • Self-contained interactive visualization
  • Modern, responsive design
  • Search and highlight functionality
  • Professional statistics dashboard
  • Offline-ready (no internet required)

JSON Data (Podfile.lock.json)

  • Structured dependency data
  • Perfect for CI/CD integration
  • Easy to parse programmatically
  • Compatible with other tools

🛠️ Development

Setup Development Environment

git clone https://github.com/erickjung/cocoapods-graph.git
cd cocoapods-graph
bundle install

Run Tests

bundle exec rake

Build Gem Locally

gem build cocoapods-graph.gemspec
gem install cocoapods-graph-*.gem

🏗️ Project Structure

cocoapods-graph/
├── lib/
│   ├── cocoapods_graph.rb          # Main module
│   └── cocoapods_graph/
│       ├── version.rb              # Version constant
│       ├── pod_class.rb            # Pod data structure
│       ├── generator.rb            # Core parsing logic
│       └── template.html           # HTML template
├── exe/
│   └── cocoapods-graph             # Executable binary
├── cocoapods-graph.gemspec         # Gem specification
└── README.md                       # This file

🤝 Contributing

We welcome contributions! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch: git checkout -b my-new-feature
  3. Make your changes and add tests if applicable
  4. Commit your changes: git commit -am 'Add some feature'
  5. Push to the branch: git push origin my-new-feature
  6. Submit a pull request

Ideas for Contributions

  • Add more visualization types (tree view, network graph)
  • Implement filtering and grouping options
  • Add export to other formats (SVG, PNG, PDF)
  • Create VS Code / Xcode extensions
  • Add support for other dependency managers

📝 Changelog

v1.0.0 (2024-XX-XX)

  • 🎉 Initial release
  • ✨ Interactive dependency wheel visualization
  • 🔍 Smart search functionality
  • 📊 Statistics dashboard
  • 📱 Responsive design
  • 🌐 Self-contained HTML output

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Erick Jung - E7G

🙏 Acknowledgments

  • Built with D3.js for beautiful visualizations
  • Inspired by the need for better dependency analysis tools
  • Thanks to the CocoaPods team for creating an amazing dependency manager

⭐ Support

If you find this tool helpful, please give it a star on GitHub! ⭐

Found a bug or have a feature request? Open an issue

Built with ❤️ by E7G