https://github.com/oelhwry/peerfit
A PHP-based social platform for connecting sports players, managing profiles, and organizing activities.
https://github.com/oelhwry/peerfit
chat-system css fullstack html javascript jquery legacy-project matchmaking mysql php social-platform sports webapp
Last synced: 20 days ago
JSON representation
A PHP-based social platform for connecting sports players, managing profiles, and organizing activities.
- Host: GitHub
- URL: https://github.com/oelhwry/peerfit
- Owner: OElhwry
- Created: 2025-06-18T14:28:38.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-04-14T03:48:42.000Z (29 days ago)
- Last Synced: 2026-04-14T05:28:50.423Z (29 days ago)
- Topics: chat-system, css, fullstack, html, javascript, jquery, legacy-project, matchmaking, mysql, php, social-platform, sports, webapp
- Language: PHP
- Homepage:
- Size: 785 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PeerFit (v1)
**Find people. Play sports. Stay active.**
PeerFit is a social sports platform for finding local players, connecting with others who share your interests, and building a community around sport. Manage your profile, explore interests and skill levels, chat with other players, and grow your network.
## Features
- User authentication with login, signup, and account management
- Profile management with sports interests and mastery levels
- User matching and friend requests with approval workflow
- Real-time chat messaging system with activity partners
- Activity and help request system
- Location-based features for finding local players
- Interest-based filtering and recommendation system
## How It Works
1. Sign up and create your profile with your sports interests
2. Set your mastery levels for different sports
3. Browse and match with other players who share your interests
4. Send friend requests to build your network
5. Chat with friends to coordinate activities and stay connected
## Tech Stack
- PHP 7+
- HTML5 / CSS3
- JavaScript (ES6)
- MySQL database
- jQuery
## Prerequisites
- XAMPP (or similar PHP development environment)
- PHP built-in server or Apache
- MySQL database
## Installation & Setup
1. **Start XAMPP:**
- Launch XAMPP Control Panel
- Start both Apache and MySQL modules
- Ensure both show as running
2. **Download & Navigate:**
- Download the Peerfit application files
- Open terminal/command prompt
- Navigate to the project directory: `cd path/to/Peerfit`
3. **Start Local Server:**
- Run the PHP development server:
```bash
php -S 127.0.0.1:8000
```
- Or use Apache (ensure files are in htdocs folder)
4. **Access Peerfit:**
- Open your browser and go to `http://127.0.0.1:8000/Startup.html`
- Sign up or log in to get started
## Project Structure
- `Startup.html` — Landing/entry point
- `login.php`, `signup.php` — Authentication pages
- `home.php` — Main activity feed
- `profile.php` — User profile management
- `account.php` — Account settings
- `chat.php` — Messaging interface
- `match_users.php` — User discovery and matching
- `requests.php` — Manage friend requests
- `edit_interests.php` — Set sports interests and skill levels
- `Images/` — Static assets and user profile pictures
## Notes
- This is v1 of PeerFit. For the latest version, see the main branch documentation.
- Ensure MySQL is properly configured before running the application.