{"id":38618039,"url":"https://github.com/rajsinghtech/claude-diagrams","last_synced_at":"2026-01-17T08:51:15.945Z","repository":{"id":306161998,"uuid":"1025199181","full_name":"rajsinghtech/claude-diagrams","owner":"rajsinghtech","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-25T11:39:11.000Z","size":847,"stargazers_count":1,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-25T13:30:14.413Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://rajsinghtech.github.io/claude-diagrams/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rajsinghtech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-23T22:20:29.000Z","updated_at":"2025-07-25T21:58:14.000Z","dependencies_parsed_at":"2025-07-24T02:12:09.091Z","dependency_job_id":"a7f9be5e-5739-46c9-a4ae-e9931e9ba222","html_url":"https://github.com/rajsinghtech/claude-diagrams","commit_stats":null,"previous_names":["rajsinghtech/claude-diagrams"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rajsinghtech/claude-diagrams","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajsinghtech%2Fclaude-diagrams","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajsinghtech%2Fclaude-diagrams/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajsinghtech%2Fclaude-diagrams/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajsinghtech%2Fclaude-diagrams/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rajsinghtech","download_url":"https://codeload.github.com/rajsinghtech/claude-diagrams/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajsinghtech%2Fclaude-diagrams/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28504554,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T06:57:29.758Z","status":"ssl_error","status_checked_at":"2026-01-17T06:56:03.931Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-17T08:51:15.439Z","updated_at":"2026-01-17T08:51:15.932Z","avatar_url":"https://github.com/rajsinghtech.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Diagrams\n\n[![Deploy to GitHub Pages](https://github.com/rajsinghtech/claude-diagrams/actions/workflows/deploy.yml/badge.svg)](https://github.com/rajsinghtech/claude-diagrams/actions/workflows/deploy.yml)\n[![Deploy PR Preview](https://github.com/rajsinghtech/claude-diagrams/actions/workflows/preview.yml/badge.svg)](https://github.com/rajsinghtech/claude-diagrams/actions/workflows/preview.yml)\n\nA gallery application for showcasing technical diagrams built with Go, Hugo, and the hugo-theme-gallery. This project provides a simple way to host and organize SVG diagrams with automated updates via Claude through GitHub Actions.\n\n## Features\n\n- 🎨 Beautiful gallery interface using hugo-theme-gallery\n- 📊 Optimized for SVG technical diagrams\n- 🚀 Single binary deployment with embedded assets\n- 🐳 Docker support for containerized deployment\n- 🤖 GitHub Actions integration for Claude-powered diagram updates\n- 🔄 Hot-reload development mode\n- 📱 Responsive design\n- 🌐 GitHub Pages deployment with PR previews\n\n## Quick Start\n\n### Prerequisites\n\n- Go 1.20 or higher\n- Hugo Extended v0.123.0 or higher\n- Docker (optional, for containerized deployment)\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/rajsinghtech/claude-diagrams.git\ncd claude-diagrams\n```\n\n2. Install Hugo modules:\n```bash\nhugo mod get\n```\n\n3. Build and run:\n```bash\n# Development mode with live reload\ngo run main.go -dev\n\n# Or build and run production server\nhugo --gc --minify\ngo build -o claude-diagrams\n./claude-diagrams\n```\n\nThe application will be available at http://localhost:8080\n\n### Docker Deployment\n\nBuild and run with Docker:\n```bash\ndocker build -t claude-diagrams .\ndocker run -p 8080:8080 claude-diagrams\n```\n\n### GitHub Pages Deployment\n\nThis project automatically deploys to GitHub Pages when changes are pushed to the main branch. Pull requests also get preview deployments.\n\n#### Setup GitHub Pages\n\n1. Go to Settings \u003e Pages in your GitHub repository\n2. Set \"Source\" to \"GitHub Actions\"\n3. The site will be available at `https://rajsinghtech.github.io/claude-diagrams/`\n\n#### PR Previews\n\nPull request previews are automatically deployed to:\n`https://rajsinghtech.github.io/claude-diagrams/pr-preview/pr-[number]/`\n\nThese previews are automatically cleaned up when the PR is closed.\n\n## Project Structure\n\n```\nclaude-diagrams/\n├── .github/workflows/    # GitHub Actions for Claude integration\n├── config/              # Hugo configuration\n├── content/             # Diagram content and metadata\n│   └── diagrams/        # Diagram categories\n│       ├── architecture/\n│       ├── flowcharts/\n│       ├── network/\n│       └── system-design/\n├── layouts/             # Custom Hugo layouts for SVG support\n├── public/              # Hugo build output (embedded in binary)\n├── main.go              # Go web server\n├── Dockerfile           # Docker configuration\n└── CLAUDE.md            # Project standards for Claude\n```\n\n## Adding Diagrams\n\n1. Create a directory for your diagram in the appropriate category:\n```bash\nmkdir content/diagrams/architecture/my-diagram\n```\n\n2. Add your SVG file and create an `index.md`:\n```markdown\n---\ntitle: \"My Architecture Diagram\"\ndescription: \"Description of the diagram\"\ndate: 2025-01-23\ncategories: [\"Technical\"]\ntags: [\"architecture\", \"microservices\"]\n---\n\nDetailed description of the diagram...\n```\n\n3. Place your SVG file in the same directory\n4. Rebuild the site\n\n## Claude Integration\n\nThis project includes GitHub Actions integration for updating diagrams using Claude. To update a diagram:\n\n1. Create an issue or pull request\n2. Comment with `@claude` followed by your request:\n```\n@claude update the microservices architecture diagram to add a caching layer\n```\n\n3. Claude will process your request and update the SVG files automatically\n\n### Setup Claude Integration\n\n1. Install the Claude GitHub App on your repository\n2. Add your Anthropic API key as a repository secret: `ANTHROPIC_API_KEY`\n3. The workflow will automatically trigger on comments containing `@claude`\n\n## Command Line Options\n\n```bash\nUsage: ./claude-diagrams [options]\n\nOptions:\n  -port string      Port to run the server on (default \"8080\")\n  -host string      Host to bind the server to (default \"0.0.0.0\")\n  -dev              Run in development mode with Hugo live reload\n  -build            Build Hugo site before starting server\n```\n\n## Development\n\n### Local Development\n\nRun in development mode for live reload:\n```bash\ngo run main.go -dev\n```\n\n### Building for Production\n\n1. Build the Hugo site:\n```bash\nhugo --gc --minify\n```\n\n2. Build the Go binary:\n```bash\ngo build -o claude-diagrams\n```\n\n## Contributing\n\n1. Follow the coding standards in `CLAUDE.md`\n2. Ensure SVG files follow the project color scheme and standards\n3. Test locally before submitting pull requests\n4. Use clear commit messages prefixed with type (feat:, fix:, docs:, diagram:)\n\n## License\n\nThis project is open source. See LICENSE file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frajsinghtech%2Fclaude-diagrams","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frajsinghtech%2Fclaude-diagrams","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frajsinghtech%2Fclaude-diagrams/lists"}