{"id":32529709,"url":"https://github.com/ryonakagami/github-issue-previewer","last_synced_at":"2026-04-30T12:33:14.813Z","repository":{"id":320257913,"uuid":"1081405099","full_name":"RyoNakagami/github-issue-previewer","owner":"RyoNakagami","description":"A lightweight tool to preview GitHub Issue templates from YAML in real-time with Jinja2 and Watchdog.","archived":false,"fork":false,"pushed_at":"2025-10-22T19:29:51.000Z","size":133,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-22T21:16:21.461Z","etag":null,"topics":["cli-tool","command-line-tool","github","github-issues","python","uv","uv-tool","uvx","yaml"],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RyoNakagami.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-10-22T18:30:30.000Z","updated_at":"2025-10-22T19:29:54.000Z","dependencies_parsed_at":"2025-10-22T21:16:31.833Z","dependency_job_id":"d91940ad-270c-43ae-a52f-8bdc8437225a","html_url":"https://github.com/RyoNakagami/github-issue-previewer","commit_stats":null,"previous_names":["ryonakagami/github-issue-previewer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/RyoNakagami/github-issue-previewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RyoNakagami%2Fgithub-issue-previewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RyoNakagami%2Fgithub-issue-previewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RyoNakagami%2Fgithub-issue-previewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RyoNakagami%2Fgithub-issue-previewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RyoNakagami","download_url":"https://codeload.github.com/RyoNakagami/github-issue-previewer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RyoNakagami%2Fgithub-issue-previewer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281427310,"owners_count":26499403,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-28T02:00:06.022Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cli-tool","command-line-tool","github","github-issues","python","uv","uv-tool","uvx","yaml"],"created_at":"2025-10-28T11:20:45.985Z","updated_at":"2025-10-28T11:20:49.516Z","avatar_url":"https://github.com/RyoNakagami.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Issue Previewer\n\n![Python](https://img.shields.io/badge/python-\u003e3.12,\u003c4-blue)\n![OS](https://img.shields.io/badge/OS-Linux%20%7C%20macOS-brightgreen)\n![License](https://img.shields.io/badge/license-MIT-orange)\n![Open Issues](https://img.shields.io/github/issues-raw/RyoNakagami/github-issue-previewer)\n![Open PRs](https://img.shields.io/github/issues-pr/RyoNakagami/github-issue-previewer)\n\nA lightweight CLI tool that provides real-time preview of GitHub Issue templates (YAML) in your browser. Perfect for designing and testing issue templates before committing them to your repository.\n\n## Features\n\n- 🔄 Live preview with automatic reload when YAML changes\n- 🎨 Authentic GitHub-style CSS theming\n- 🌐 Local HTTP server with hot-reload capability\n- ⚡ Fast and lightweight\n- 🚀 Simple CLI interface\n- 🔌 Custom browser support\n\n## Installation\n\nThis project uses [uv](https://github.com/astral-sh/uv) for package management. Make sure you have uv installed first.\n\n```bash\n# Install using uv\nuv tool install git+https://github.com/RyoNakagami/github-issue-previewer\n\n# Uninstall if needed\nuv tool uninstall github-issue-previewer\n```\n\n## Usage\n\nBasic usage:\n\n```bash\ngithub-issue-previewer path/to/issue_template.yml [--port PORT] [--browser BROWSER_PATH]\n```\n\n### Arguments\n\n- `yaml_file`: Path to your GitHub issue template YAML file (required)\n- `--port`: Port number for the preview server (default: 8000)\n- `--browser`: Custom browser path (optional)\n\n### Example Usage\n\nGiven a feature request template like this:\n\n```yaml\nname: \"Feature Request\"\ndescription: \"Suggest a new feature or improvement\"\ntitle: \"FEATURE: \"\nlabels: [feature]\n\nbody:\n  - type: textarea\n    id: feature-goal\n    attributes:\n      label: \"Feature Goal\"\n      description: \"Describe the new feature you want to see added.\"\n    validations:\n      required: true\n```\n\nPreview it with:\n\n```bash\ngithub-issue-previewer .github/ISSUE_TEMPLATE/feature_request.yml\n```\n\n![feature_request sample](./assets/preview-sample.png)\n\nThis will:\n\n1. Generate an HTML preview styled like GitHub\n2. Open your default browser\n3. Start watching for changes in the YAML file\n4. Auto-refresh the preview whenever you edit the template\n\n## How It Works\n\n1. Reads your GitHub Issue template YAML file\n2. Converts it to HTML using Jinja2 templates\n3. Applies GitHub-style CSS theming\n4. Serves the preview via a local HTTP server\n5. Watches for file changes and triggers live reload\n6. Updates the preview in real-time as you edit\n\n## Requirements\n\n- Python \u003e=3.12\n- [uv](https://github.com/astral-sh/uv) package manager\n\n## Contributing\n\nContributions are welcome! For major changes:\n\n1. Open an issue first to discuss proposed changes\n2. Fork the repository\n3. Create a feature branch\n4. Submit a pull request\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fryonakagami%2Fgithub-issue-previewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fryonakagami%2Fgithub-issue-previewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fryonakagami%2Fgithub-issue-previewer/lists"}