The Adventurers Guild is an innovative educational platform that gamifies computer science learning by connecting students with real-world projects from companies. Students (called "Adventurers") progress through skill trees, earn experience points (XP), and advance through a ranking system (F to S rank) by completing "Quests" - which are actual digital projects commissioned by companies.
- Gamified Learning: Progress from F-Rank to S-Rank through real-world projects
- Quest System: Complete authentic projects commissioned by real companies
- Skill Trees: Visualize and develop your technical expertise
- Ranking System: Compete with peers through our XP and ranking system
- Payment Integration: Earn monetary rewards for completed quests
- Company Portal: Post quests and find talented developers
- Real-time Collaboration: Work directly with adventurers in shared development environments
- Code Review: Built-in review system for quality assurance
- Version Control: Integrated Git workflow for project management
- Live Coding: Collaborative coding sessions with mentors and peers
- Progress Tracking: Real-time progress visibility for both parties
- Role-Based Access: Adventurers, Companies, and Admins
- Secure Authentication: NextAuth.js with Supabase integration
- Permission Management: Granular access controls for different user types
- Frontend: Next.js 15, React, TypeScript, Tailwind CSS
- UI Components: shadcn/ui with Lucide React icons
- Database: Supabase (PostgreSQL)
- Authentication: NextAuth.js with Supabase
- Deployment: Vercel
- DevSync Integration: Collaborative coding platform
- Payment Processing: Stripe integration for monetary rewards
- Node.js (LTS version recommended)
- npm or Yarn
- Git
- Supabase account (for database and authentication)
- Stripe account (for payment processing)
git clone https://github.com/LarytheLord/adventurers-guild.git
cd adventurers-guildnpm installCreate a .env.local file in the root directory with the required variables:
# Supabase
NEXT_PUBLIC_SUPABASE_URL=your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key-here
# Authentication
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=generate-with-openssl-rand-base64-32
# Email (SMTP)
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your-email@gmail.com
SMTP_PASS=your-app-password
ADMIN_EMAIL=admin@adventurersguild.com
# Application
NEXT_PUBLIC_APP_URL=http://localhost:3000
# DevSync Integration (optional)
NEXT_PUBLIC_DEVSYNC_API_URL=https://api.devsync.codes
DEVSYNC_API_KEY=your-devsync-api-key
# Stripe (for payments)
STRIPE_SECRET_KEY=your-stripe-secret-key
STRIPE_WEBHOOK_SECRET=your-webhook-secretnpm run devThe application will be available at http://localhost:3000
- Browse and accept quests
- Earn XP, skill points, and monetary rewards
- Climb the ranks from F to S
- Build portfolio with real projects
- Collaborate in real-time through DevSync integration
- Post quests for adventurers to complete
- Access to pre-vetted student talent
- Pay for completed work
- Review and approve submissions
- Access collaborative coding environments
- Manage users and quests
- Moderate the platform
- Handle disputes
- Monitor platform health
- Join the Guild: Create your adventurer profile
- Choose Quests: Browse available quests matching your skills
- Accept Quest: Commit to completing a project
- Collaborate: Work with company representatives and other adventurers
- Submit Work: Complete the quest and submit for review
- Earn Rewards: Receive XP, skill points, and monetary rewards
- Climb Ranks: Progress from F-Rank to S-Rank
- Register: Create your company profile
- Post Quests: Describe the project you need completed
- Review Applicants: Select the right adventurers for your project
- Collaborate: Work directly with adventurers through DevSync
- Review Work: Approve completed projects
- Pay Adventurers: Reward successful quest completion
- Platform Commission: 15-20% commission on quest payments
- Premium Subscriptions: Enhanced features for companies and adventurers
- Corporate Licensing: For universities and training organizations
- Featured Quests: Promoted placement for premium listings
We welcome contributions of all skill levels! Please read our CONTRIBUTING.md for detailed guidelines on:
- Finding and claiming issues
- Development workflow
- Code standards
- Pull request process
Check out our GitHub Issues for tasks categorized by difficulty:
- F-Rank: Beginner-friendly tasks
- E-Rank: Simple improvements
- D-Rank: Moderate complexity
- C-Rank: Feature development
- B-Rank: Complex features
- A-Rank: Major system changes
- S-Rank: Epic-level challenges
- CONTRIBUTING.md - Contribution guidelines
- DEVELOPMENT.md - Development setup and architecture overview
- CODE_OF_CONDUCT.md - Community standards
- DEVSYNC_INTEGRATION_PLAN.md - DevSync integration specifications
- Discord: Join our Community!
- Website: The Adventurers Guild
- GitHub: Adventurers Guild
This project is licensed under the MIT License - see the LICENSE file for details.
- Core Features: Implemented
- Authentication: Complete
- Quest Management: Fully functional
- Payment Processing: Integrated
- DevSync Integration: Planned and documented
- User Dashboard: Complete
- Company Portal: Complete
- Launch with Universities: Partner with GTU and other institutions
- Pilot Companies: Start with Knight Medicare, Open Paws, and similar companies
- Community Building: Focus on Discord engagement and success stories
- Scale Gradually: Expand to more universities and companies
- International Expansion: Target global educational institutions
- Complete DevSync integration
- Launch with 5 pilot universities
- Onboard 25+ companies
- Achieve 1,000+ registered adventurers
- Implement advanced matching algorithms
- Launch mobile applications
- Expand to international markets
- Process ₹5L+ in quest payments
- AI-powered skill assessment
- Corporate training licensing
- Advanced analytics dashboard
- Series A funding round