{"id":35163929,"url":"https://github.com/ducks/discourse-frndr","last_synced_at":"2026-05-21T06:02:56.465Z","repository":{"id":320481718,"uuid":"1082228251","full_name":"ducks/discourse-frndr","owner":"ducks","description":"Friend finding app built on Discourse - match people based on interests and compatibility.","archived":false,"fork":false,"pushed_at":"2025-10-24T03:03:44.000Z","size":462,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-24T03:38:12.538Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","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/ducks.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-23T23:37:02.000Z","updated_at":"2025-10-24T03:03:47.000Z","dependencies_parsed_at":"2025-10-24T03:38:21.936Z","dependency_job_id":null,"html_url":"https://github.com/ducks/discourse-frndr","commit_stats":null,"previous_names":["ducks/discourse-frndr"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ducks/discourse-frndr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ducks%2Fdiscourse-frndr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ducks%2Fdiscourse-frndr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ducks%2Fdiscourse-frndr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ducks%2Fdiscourse-frndr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ducks","download_url":"https://codeload.github.com/ducks/discourse-frndr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ducks%2Fdiscourse-frndr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33290928,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-21T02:57:32.698Z","status":"ssl_error","status_checked_at":"2026-05-21T02:57:31.990Z","response_time":62,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-12-28T19:03:35.848Z","updated_at":"2026-05-21T06:02:56.454Z","avatar_url":"https://github.com/ducks.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# discourse-frndr\n\nFriend finding app built on Discourse - match people based on interests and compatibility.\n\n## Overview\n\nFrndr transforms Discourse into a friend-finding platform. Users fill out profile questions, tag their intro topics with activities, and discover compatible friends through a matching algorithm.\n\n## Features\n\n- **Compatibility Matching**: Algorithm compares user profile answers to calculate compatibility percentage\n- **Discovery Page**: Card-based UI showing potential matches with compatibility scores\n- **Activity Tags**: Users tag intro topics with activities (hiking, board games, etc.)\n- **Profile Questions**: Uses Discourse's built-in user fields for profile data\n\n## Installation\n\n1. Clone this repository to your Discourse plugins directory:\n   ```bash\n   cd ~/discourse/discourse/plugins\n   git clone https://github.com/ducks/discourse-frndr.git\n   ```\n\n2. Or symlink during development:\n   ```bash\n   ln -s ~/dev/discourse-frndr ~/discourse/discourse/plugins/discourse-frndr\n   ```\n\n3. Restart Discourse:\n   ```bash\n   cd ~/discourse/discourse\n   bin/rails restart\n   ```\n\n4. Enable the plugin in Admin \u003e Settings \u003e Plugins\n\n## Configuration\n\n### User Fields (Profile Questions)\n\nCreate user fields in Admin \u003e Customize \u003e User Fields:\n\n1. Go to Admin \u003e Customize \u003e User Fields\n2. Add fields with options like:\n   - \"How social are you?\" (1-3 scale: 1=Introvert, 2=Balanced, 3=Extrovert)\n   - \"Preferred activity time?\" (1=Mornings, 2=Afternoons, 3=Evenings)\n   - \"Activity level?\" (1=Low, 2=Moderate, 3=High)\n\n### Activity Tags\n\nCreate tags for activities in Admin \u003e Tags:\n- `hiking`\n- `board-games`\n- `cooking`\n- `music`\n- etc.\n\n### Intro Topics Category\n\nCreate a dedicated category for intro topics:\n1. Admin \u003e Categories \u003e New Category\n2. Name: \"Introductions\" or \"Find Friends\"\n3. Restrict to one topic per user (configure in category settings)\n\n## Usage\n\n### For Users\n\n1. Fill out profile questions in user preferences\n2. Create an intro topic in the Introductions category\n3. Tag it with your activities\n4. Visit `/discover` to see compatible matches\n\n### Discovery Page\n\nAccess at: `https://your-forum.com/discover`\n\nThe page shows:\n- Avatar and username of potential matches\n- Compatibility percentage\n- Link to view their full profile\n\n## Testing\n\n### Quick Start with Test Data\n\n1. **Create example user fields** (one-time setup):\n   ```bash\n   cd ~/discourse/discourse\n   bin/rails runner plugins/discourse-frndr/scripts/create-test-user-fields.rb\n   ```\n   This creates 5 user fields with realistic options:\n   - Activity Level (Very Active, Moderately Active, Casual, Laid Back)\n   - Social Preference (Large Groups, Small Groups, One-on-One, Any Size)\n   - Meeting Time (Weekday Mornings, Weekday Evenings, Weekends, Anytime)\n   - Communication Style (Very Direct, Balanced, Diplomatic, Very Tactful)\n   - Interests (multiselect: Outdoors, Technology, Arts \u0026 Crafts, etc.)\n\n2. **Generate test users with random answers**:\n   ```bash\n   bin/rails runner plugins/discourse-frndr/scripts/create-test-users.rb\n   ```\n   Creates 30 users (Alice, Bob, Charlie, etc.) with randomly selected answers.\n   All users have password: `TestPass123!@#`\n\n3. **Test the matching**:\n   - Visit `/discover` as any test user\n   - Or test in Rails console:\n     ```ruby\n     alice = User.find_by(username: \"alice\")\n     matches = Frndr::Matcher.find_matches_for(alice)\n     matches.first # =\u003e { user: #\u003cUser\u003e, compatibility: 75 }\n     ```\n\n### Manual Testing\n\n```bash\ncd ~/discourse/discourse\nbin/rails console\n```\n\n```ruby\n# Test compatibility between two users\nalice = User.find_by(username: \"alice\")\nbob = User.find_by(username: \"bob\")\nFrndr::Matcher.calculate_compatibility(alice, bob)\n# =\u003e Returns percentage (0-100)\n\n# Check what fields they have set\nalice.user_fields  # =\u003e { \"1\" =\u003e \"Very Active\", \"2\" =\u003e \"Small Groups\", ... }\nbob.user_fields    # =\u003e { \"1\" =\u003e \"Casual\", \"2\" =\u003e \"Small Groups\", ... }\n```\n\n## Architecture\n\nSee [ARCHITECTURE.md](./ARCHITECTURE.md) for detailed technical documentation.\n\n## Development\n\n### Project Structure\n\n```\ndiscourse-frndr/\n├── plugin.rb                 # Main plugin file\n├── lib/\n│   └── frndr/\n│       ├── engine.rb         # Rails engine\n│       └── matcher.rb        # Matching algorithm\n├── app/\n│   └── controllers/\n│       └── frndr/\n│           └── discover_controller.rb\n├── assets/\n│   ├── javascripts/discourse/\n│   │   ├── routes/\n│   │   │   └── discover.js\n│   │   └── templates/\n│   │       └── discover.hbs\n│   └── stylesheets/\n│       └── frndr.scss\n└── scripts/\n    └── create-test-users.sh\n```\n\n### Running Tests\n\n```bash\ncd ~/discourse/discourse\nbin/rake plugin:spec[discourse-frndr]\n```\n\n## Roadmap\n\n- [ ] One intro topic per user validation\n- [ ] Filter matches by activity tags\n- [ ] Location-based matching\n- [ ] Weighted questions (importance levels)\n- [ ] \"Pass\" and \"Like\" actions\n- [ ] Direct messaging integration\n- [ ] Activity-based notifications\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fducks%2Fdiscourse-frndr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fducks%2Fdiscourse-frndr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fducks%2Fdiscourse-frndr/lists"}