Where code meets community. Build, share, and grow together.
Features • Documentation • Quick Start • Tech Stack • Contributing
- 🎯 Overview
- ✨ Features
- 🚀 Quick Start
- 📚 Documentation
- 🛠️ Tech Stack
- 🗺️ Roadmap
- 🤝 Contributing
- 📬 Community
- 📄 License
Hunter is a social network built by developers, for developers. It's a place where you can showcase your skills, share your coding journey, connect with like-minded professionals, and build meaningful relationships in the tech community.
Current Stack: Laravel 12.32.5 | React 19.1 | PHP 8.4.13
Recent improvements and features:
- 💬 Enhanced Chat System - Real-time messaging with WebSocket support via Laravel Reverb
- 🎨 Modern UI Components - Complete Radix UI integration with Tailwind CSS v4
- 📱 PWA Support - Progressive Web App with offline capabilities and service worker
- 🔒 Security Enhancements - Active session management and improved authentication
- ⚡ Performance - Optimized queries, Meilisearch integration, and Redis caching
- 🧪 Testing - Comprehensive test suite with Pest PHP v4
The developer community needed a platform that truly understands their needs:
- 👤 Beyond Code: Portfolios are static. GitHub is technical but impersonal. We bring the human element to your professional identity.
- 💬 Real Connections: A space for devs to share ideas, thoughts, and reflections—not just code.
- 🌱 Community Growth: Build genuine relationships and collaborate with developers who share your passions.
- 🎯 Developer-First: No hidden algorithms, no corporate interests—just a community built for developers.
|
Create a comprehensive profile that showcases who you are:
|
Share your developer journey:
|
|
Build your developer network:
|
Collaborate instantly:
|
|
Modern mobile experience:
|
Advanced protection features:
|
- Full-text Search powered by Meilisearch
- Skill-based Discovery to find developers by tech stack
- Location Filters for local connections
- Personalized Recommendations
- PHP 8.4.13+
- Composer 2.x
- Node.js 20+ / npm 10+
- PostgreSQL 14+
- Redis (for cache, queues & WebSockets)
- Meilisearch (optional, for search)
# Clone the repository
git clone https://github.com/akira-io/devhunter.git
cd devhunter
# Install dependencies
composer install
npm install
# Set up environment
cp .env.example .env
php artisan key:generate
# Configure your database in .env (PostgreSQL recommended)
# DB_CONNECTION=pgsql
# DB_HOST=127.0.0.1
# DB_DATABASE=devhunter
# Run migrations
php artisan migrate
# Start the development server
php artisan serve
# In another terminal, start Vite
npm run dev🐳 Using Docker (Laravel Sail)
# Install Sail
composer require laravel/sail --dev
# Start containers
./vendor/bin/sail up -d
# Run migrations
./vendor/bin/sail artisan migrate🦌 Using Laravel Herd
- Install Laravel Herd
- Link your project directory
- Access at
https://devhunter.test - No need to run
php artisan serve
📖 For detailed installation instructions, see the Getting Started Guide
📖 Comprehensive documentation is available in English in the /docs folder!
All documentation includes practical examples and is optimized for production use with PostgreSQL.
| Category | Documents | Description |
|---|---|---|
| 🚀 Getting Started | Installation Guide | Complete setup instructions |
| Quick Reference | Common commands & examples | |
| 🔐 Core Features | Authentication | Login, OAuth, security |
| User Profiles | Profile management | |
| Hunts (Posts) | Creating and managing posts | |
| Social Features | Follow, like, comment | |
| 💬 Real-time | Real-time Chat | WebSocket chat system |
| Chat Architecture | Advanced chat implementation | |
| Advanced Chat | Reply, edit, reactions, search | |
| 🔍 Discovery | Search & Discovery | Meilisearch integration |
| 🎨 UI/UX | Hunt Creation UX | Modern hunt creation interface |
| Markdown Editor | Rich markdown editing system | |
| 🔔 Engagement | Notifications | Real-time & email notifications |
| Gamification | XP, Levels, Badges, Rewards | |
| 🔒 Security | Privacy & Security | Privacy controls & 2FA |
| 🛠️ Development | API Reference | Complete API documentation |
| Frontend Development | React, TypeScript, Inertia | |
| Testing | Pest PHP testing guide | |
| Deployment | Production deployment guide |
💡 Start here: New developers should begin with the Getting Started Guide
|
Framework & Core
|
Real-time & Search
|
|
UI & Styling
|
State & Navigation
|
| Package | Version | Purpose |
|---|---|---|
akira/laravel-followable |
0.2.0 | Following system |
akira/laravel-likeable |
0.2.0 | Like functionality |
akira/laravel-commentable |
1.x-dev | Comments system |
akira/laravel-auth-logs |
1.0.0 | Authentication tracking |
spatie/laravel-medialibrary |
11.12+ | Media management |
laravel/socialite |
5.23 | OAuth (GitHub & Google) |
laravel/horizon |
5.34 | Queue monitoring |
laravel/pulse |
1.4 | Application monitoring |
laravel/nightwatch |
1.14 | Error tracking |
laravel/wayfinder |
0.1.12 | Type-safe routing |
spatie/laravel-activitylog |
4.10+ | Activity logging |
spatie/laravel-query-builder |
6.3+ | API query building |
📖 For more technical details, see the complete documentation
-
Authentication & Authorization
- User registration & login
- OAuth integration (GitHub & Google)
- Email verification
- Password reset
- Authentication logs
-
Developer Profiles
- Profile creation and customization
- Avatar and cover images
- Skills and technologies display
- Academic background
- Social links (GitHub, LinkedIn, Twitter, etc.)
-
Hunts (Posts) System
- Create, edit, and delete Hunts
- Media attachments
- Comments system
- Like functionality
- Hunt feed with pagination
-
Social Features
- Follow/unfollow system
- Followers and following lists
- Activity feeds
- User discovery
- Global search
-
Real-time Chat
- WebSocket-powered messaging (Laravel Reverb)
- Private direct conversations
- Read receipts and message status
- Online presence indicators
- Unread message counts with badges
- Mobile-optimized UI with iOS keyboard handling
- Auto-scroll to latest messages
- Real-time message delivery
-
Notifications System
- Real-time in-app notifications
- Email notifications (independent settings)
- Notification preferences
- Follow, like, and comment notifications
-
Search & Discovery
- Full-text search with Meilisearch
- User search with filters
- Hunt search with relevance
- Skill-based discovery
- Debounced search input
- Real-time search results
-
Progressive Web App (PWA)
- Installable on all platforms
- Offline support with service worker
- App manifest for native-like experience
- Automatic cache versioning
- Optimized asset loading
- iOS safe area support
-
Enhanced Gamification (Issues #129-188)
- Points & Rewards system
- Hunter levels & badges
- Leaderboards (weekly, monthly, all-time)
- XP for user actions
- Badge unlocking and display
- Rewards shop with perks
- Anti-abuse and fraud detection
- Gamification dashboard
-
Advanced Chat Features (Issues #145-152)
- Reply to messages (threading)
- Forward messages
- Edit sent messages
- Delete messages
- Message reactions (emoji)
- Quote messages
- Search messages in conversations
- Save/bookmark messages
- Read receipts with elapsed time
-
Privacy & Security (Issues #169-177)
- Profile visibility settings
- Messaging privacy controls
- Hunt comments privacy
- Search/Explore visibility
- Online status visibility
- Blocked users management
- Security section (password, 2FA, sessions)
- Account deletion
-
Enhanced Profiles
- Project highlights (Issue #168)
- Profile completion indicator (Issue #24)
- Dedicated education table (Issue #25)
- Technologies showcase (Issue #22)
-
Onboarding & Tutorials
- Welcome tutorial with replay option (Issues #178-182)
- Contextual tutorial suggestions
- Step-by-step replay
- Core user actions tracking
-
Search Enhancements (Issues #156-159)
- Recent searches
- Search highlights in results
- Search filters and categories
- Search analytics
-
UI/UX Improvements
- Notification settings visual feedback (Issue #177)
- Chat icon hide/show on scroll (Issue #162)
- Notification time window filter (Issue #164)
- Profile icon labels (Issue #167)
-
Inertia v2.2 Features
- Infinite scroll implementation (Issue #136)
- Lazy loading (Issue #137)
- Prefetching (Issue #138)
-
Code Architecture
- Route attributes migration (Issue #141)
- Performance optimizations
- Database query optimization
-
Community Moderation
- Report Hunts or profiles (Issue #127)
- Block or mute Hunters (Issue #128)
- Content moderation tools
-
Mobile Applications
- iOS app (Swift)
- Android app (Kotlin / Flutter / React Native)
- PWA support
-
Developer Tools
- Job board integration
- Project collaboration features
- Code snippet sharing
- Markdown support for posts
-
Community Features
- Developer groups/communities
- Events & meetups
- Mentorship program
- Achievement system
-
Platform Enhancements
- Multiple language support
- Developer analytics & insights
- Learning resources section
- Open source project showcase
💬 Have suggestions? Check our GitHub Issues or join our Discord to share your ideas!
We welcome contributions from developers of all skill levels! Whether you're fixing a bug, adding a feature, or improving documentation, your help is appreciated.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow the existing code style
- Write tests for new features
- Update documentation as needed
- Keep commits atomic and well-described
- Run tests before submitting PR:
php artisan test
Please read our Code of Conduct to understand what behavior we expect from all participants in the Dev Hunter community.
📖 For detailed contributing guidelines, see CONTRIBUTING.md
Join our vibrant community of developers!
|
Chat with the team and community |
Found a bug? Let us know! |
General inquiries |
- ⭐ Star this repository
- 🐛 Report bugs and issues
- 💡 Suggest new features
- 📖 Improve documentation
- 🔀 Submit pull requests
- 💬 Share Hunter with others
This project is licensed under the GNU Affero General Public License v3.0.
This means:
- ✅ You can use, modify, and distribute this software
- ✅ Source code must be made available
- ✅ Changes must be documented
- ✅ Network use is considered distribution
Website • Documentation • Discord • * GitHub*
⭐ Star us on GitHub — it helps!