How github/forgoodfirstissue works
For Good First Issue is a Next.js site that helps contributors discover social-impact and civic-tech repositories and their tagged issues, with a separate teams directory. The main path is curated repository data, loaded into app state, searched and filtered, then shown with expandable issue lists. The README documents a GitHub API generation step; the organization-list implementation is represented from the tree and indexed references, but its data source is not established by the excerpts. Edges are limited to documented or indexed relationships.
Main entry points: RepositoryList.tsx Repository search and filters · RepositoryItem.tsx Repository card · OrganizationList.tsx Organization directory · generate.ts Issue data generator
Components 24
Data preparation
- Curated projects
happycommits.json - Issue data generator
generate.ts - Generated data
generated.json - Organization generator
generate-organizations.ts
Application state
- App data context
context/AppDataContext.tsx - App data hook
hooks/useAppData.tsx
Project discovery
- Individual discovery page
pages/index.tsx - Repository search and filters
components/RepositoryList.tsx - Language filter
components/LanguageFilter.tsx - SDG filter
components/SDGFilter.tsx - Repository card
components/RepositoryItem.tsx - Repository heading
components/RepositoryItemTopBar.tsx - Repository metadata
components/RepositoryMetadata.tsx - Issue list
components/IssueList.tsx - Issue entry
components/IssueItem.tsx
Teams directory
- Teams page
pages/teams.tsx - Organization directory
components/OrganizationList.tsx - Organization card
components/OrganizationItem.tsx - Organization filters
components/GeneralFilter.tsx - Language filter
components/LanguageFilter.tsx - Organization metadata
components/OrganizationMetadata.tsx
Other components
- Contributor
- Project maintainer
- GitHub API
Connections 22
- Project maintainer → Curated projects: curates
README.md - Curated projects → Issue data generator: lists repositories
README.md - Issue data generator → GitHub API: fetches issues
README.md - Issue data generator → Generated data: generates data
README.md - Generated data → App data context: loads
context/AppDataContext.tsx - App data context → App data hook: provides context
hooks/useAppData.tsx - Contributor → Individual discovery page: browses
- Individual discovery page → App data hook: reads repositories
pages/index.tsx - Individual discovery page → Repository search and filters: renders
pages/index.tsx - Repository search and filters → Language filter: renders
components/RepositoryList.tsx - Repository search and filters → SDG filter: renders
components/RepositoryList.tsx - Repository search and filters → Repository card: renders
components/RepositoryList.tsx - Repository card → Repository heading: renders
components/RepositoryItem.tsx - Repository card → Repository metadata: renders
components/RepositoryItem.tsx - Repository card → Issue list: renders
components/RepositoryItem.tsx - Issue list → Issue entry: renders
components/IssueList.tsx - Contributor → Teams page: browses
- Teams page → Organization directory: renders
pages/teams.tsx - Organization directory → Organization filters: renders
components/OrganizationList.tsx - Organization directory → Language filter: renders
components/OrganizationList.tsx - Organization directory → Organization card: renders
components/OrganizationList.tsx - Organization card → Organization metadata: renders
components/OrganizationItem.tsx