{"id":28217208,"url":"https://github.com/nating/penpal","last_synced_at":"2025-08-20T02:13:37.477Z","repository":{"id":284802086,"uuid":"955999674","full_name":"nating/Penpal","owner":"nating","description":"Connect with real humans to practice your target language","archived":false,"fork":false,"pushed_at":"2025-04-09T11:28:24.000Z","size":283,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-18T00:11:35.061Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/nating.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}},"created_at":"2025-03-27T14:36:44.000Z","updated_at":"2025-04-09T11:28:28.000Z","dependencies_parsed_at":"2025-03-27T19:26:01.216Z","dependency_job_id":"c98a9f9f-4dfb-4058-b80b-eb58402f6240","html_url":"https://github.com/nating/Penpal","commit_stats":null,"previous_names":["nating/penpal"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nating/Penpal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nating%2FPenpal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nating%2FPenpal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nating%2FPenpal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nating%2FPenpal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nating","download_url":"https://codeload.github.com/nating/Penpal/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nating%2FPenpal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271252993,"owners_count":24726918,"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-08-20T02:00:09.606Z","response_time":69,"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":[],"created_at":"2025-05-18T00:11:34.723Z","updated_at":"2025-08-20T02:13:37.467Z","avatar_url":"https://github.com/nating.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"penpal-logo\" src=\"./public/app-icon.svg\" width=\"200\"\u003e\u003ca/\u003e\n\u003c/p\u003e\n\n\u003ch2 align=\"center\"\u003ePenpal\u003ch2/\u003e\n\u003cp align=\"center\"\u003e\n  \u003ci align=\"center\"\u003eThe real-human language exchange matching app\u003c/i\u003e\n\u003c/p\u003e\n\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/badge/license-MIT-blue.svg\"\u003e\u003ca/\u003e\n\u003ca href=\"http://makeapullrequest.com\"\u003e\u003cimg alt=\"PRs Welcome\" src=\"https://img.shields.io/badge/pull%20requests-welcome-brightgreen.svg\"\u003e\u003ca/\u003e\n\u003c/p\u003e\n\n---\n\n## Overview\n\nPenpal is a mini app that helps you connect with **real humans** who speak your *target language*, so you can **practice** and **improve** together. Our matching algorithm ensures you're paired with the right person, and you can chat safely through the World app – making it easy to find genuine partners for language exchange.\n\n**Features include**:\n\n- **One-click matching**: Just select your language and your target partner’s language, and the app does the rest.  \n- **Secure sign-in** with World – ensures you're talking to real people, not bots.  \n- **Lightweight** UI with quick, minimal transitions.  \n- **Cancel** or **Delete** your match easily if you're no longer interested.  \n- **“Start Chat”** button for direct conversation once matched.\n\n---\n\n## How It Works\n\n1. **Sign In with World**  \n   - Verifies that you’re a real human and fetches your World username.  \n2. **Request a Penpal**  \n   - Select your current language and the language you wish to learn.  \n   - The app searches for a suitable partner who wants to learn your language.  \n3. **Get Matched**  \n   - Once a match is found, you’ll see their username – plus an option to start chatting.  \n4. **Build Your Skills**  \n   - Practice your target language with a real human partner.  \n   - If you want a new partner, remove the old match and request again.\n\n---\n\n## Tech Stack\n\n- **[Next.js 15](https://nextjs.org/)** – App Router  \n- **[Tailwind CSS](https://tailwindcss.com/)** – for styles and utility classes  \n- **[Supabase](https://supabase.com/)** – data storage (penpal requests, matching info)  \n- **[MiniKit (World App)](https://developer.world.org/)** – secure real-human verification \u0026 incognito actions  \n\n---\n\n## Contributing\n\nWe welcome contributions! Feel free to open issues for feature requests, bug reports, or general improvements. Submit a PR, and we’ll review it as soon as possible.\n\n**Steps to Contribute:**\n1. Fork this repository.\n2. Create a feature branch.\n3. Commit your changes with clear commit messages.\n4. Submit a Pull Request.\n\nPlease ensure all commits pass our lint checks and do not break existing tests.\n\n## License\n\n[MIT License](./LICENSE)\n\n**© 2025 Penpal** – connect with real humans, learn new languages faster.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnating%2Fpenpal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnating%2Fpenpal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnating%2Fpenpal/lists"}