IssueFlow

Find unassigned GitHub issues without pull requests
Streamline your path to open source contribution

Live App | Report Bug | Request Feature

What is IssueFlow?

IssueFlow helps developers discover contribution-ready GitHub issues by filtering for:

• Open issues with no assignee
• Issues without linked pull requests (with token)
• Easy-to-start issues with zero comments

Quick Start

git clone https://github.com/VibeTensor/IssueFlow.git
cd IssueFlow
npm install
npm run dev

Open http://localhost:4321

Usage

Without Token (Quick Search)

1. Paste any GitHub repo URL
2. Click "Find Issues"
3. Browse unassigned issues

Rate limit: 60 requests/hour

With GitHub Token (Recommended)

1. Generate a token with public_repo scope
2. Paste token in the app
3. Get full PR filtering + 5000 requests/hour

Tokens are stored locally in your browser only, never sent to any server except GitHub's API.

Features

November 2025 Features

Zero-Comment Issue Highlighting

• Visual indicators for issues with no comments
• Easy identification of untouched issues ideal for new contributors
• Filter to show only zero-comment issues

Smart Relative Time Display

• Human-readable timestamps ("Today", "Yesterday", "3 days ago")
• Freshness indicators (fresh, moderate, stale)
• Hover tooltips showing exact date and time

Auto-Focus and URL Validation

• Input field auto-focuses on page load
• Real-time GitHub URL validation
• Clear error messages for invalid URLs

Export Issues

• Export to Markdown format
• Export to CSV for spreadsheet analysis
• Export to plain text

Copy Issue Link

• One-click copy of issue URL to clipboard
• Visual feedback on successful copy

Core Features

• Real-time rate limit display
• Mobile-responsive design
• Sort by comment count

Tech Stack

• Framework: Astro 5.x
• UI Components: Svelte 5
• Styling: UnoCSS
• API: GitHub GraphQL + REST fallback
• Language: TypeScript
• Hosting: Cloudflare Pages

Project Structure

IssueFlow/
├── public/                 # Static assets (favicon, images)
├── src/
│   ├── components/
│   │   ├── results/        # Issue display components
│   │   └── shared/         # Reusable UI components
│   ├── lib/                # Utility functions
│   │   ├── github-graphql.ts
│   │   ├── issue-utils.ts
│   │   └── time-utils.ts
│   └── pages/              # Astro pages
├── tests/                  # Test files
├── astro.config.mjs
├── package.json
└── tsconfig.json

Contributing

Contributions welcome! This is a Hacktoberfest-friendly project.

1. Fork the repository
2. Create your branch (git checkout -b feature/awesome)
3. Commit changes (git commit -m 'Add awesome feature')
4. Push to branch (git push origin feature/awesome)
5. Open a Pull Request

PRs get automatic preview deployments via Cloudflare Pages. Once merged to master, changes are automatically deployed to production.

See CONTRIBUTING.md for detailed guidelines.

Good First Issues

• good first issue
• hacktoberfest
• help wanted

Privacy

• No analytics or tracking
• No server-side data collection
• Tokens stored in browser localStorage only
• Open source and auditable

License

MIT

About

IssueFlow is an open source project by VibeTensor Private Limited.

If you find this helpful, please star the repo!