How ersozberk/awesome-turkiye works
Awesome Türkiye is a curated catalog of Turkish open-source projects, communities, and digital-life resources, presented both as bilingual READMEs and an interactive discovery site. Contributors maintain the central JSON catalog; the Go validator checks listed repository links, the Go generator renders English and Turkish READMEs, and the website loads catalog data for category browsing and search. The README documents these capabilities; code excerpts show the catalog-to-website and generator/validator behavior. CI wiring and unsampled schema details are not mapped.
Main entry points: page.tsx Discovery Page · data.json Project Catalog · readme-gen/main.go README Generator · validator/main.go Link Validator
Components 14
Catalog Data
- Project Catalog
data/data.json - Data Schema
data/schema.json
Web Discovery
- Discovery Page
website/src/app/page.tsx - Catalog Reader
website/src/app/utils/getData.ts - Search Dashboard
website/src/components/Dashboard.tsx - Site Layout
website/src/app/layout.tsx - Social Preview
website/src/app/opengraph-image.tsx
Catalog Maintenance
- README Generator
scripts/cmd/readme-gen/main.go - English README
README.md - Turkish README
README.tr.md - Link Validator
scripts/cmd/validator/main.go
Other components
- Contributor
- Web Visitor
- Project Repositories
Connections 13
- Contributor → Project Catalog: maintains
README.md - Web Visitor → Discovery Page: opens
website/src/app/page.tsx - Discovery Page → Catalog Reader: loads data
website/src/app/page.tsx - Catalog Reader → Project Catalog: reads
website/src/app/utils/getData.ts - Discovery Page → Search Dashboard: renders
website/src/app/page.tsx - Discovery Page → Site Layout: uses layout
- Web Visitor → Search Dashboard: searches catalog
website/src/components/Dashboard.tsx - Web Visitor → Social Preview: shares site
- README Generator → Project Catalog: reads
scripts/cmd/readme-gen/main.go - README Generator → English README: generates
scripts/cmd/readme-gen/main.go - README Generator → Turkish README: generates
scripts/cmd/readme-gen/main.go - Link Validator → Project Catalog: reads
scripts/cmd/validator/main.go - Link Validator → Project Repositories: checks links
scripts/cmd/validator/main.go