The Adventurers Guild is a gamified developer marketplace that connects students and developers with real-world projects from companies and NGOs. Adventurers progress through ranks (F to S), earn XP, and get paid by completing Quests — actual development tasks commissioned by real organisations.
Part of the Open Paws ecosystem, integrating with the Open Paws Bootcamp and Internship Programme.
- Gamified Learning: Progress from F-Rank to S-Rank through real-world projects
- Quest System: Complete authentic projects commissioned by real companies
- Two-Track Architecture: Open quests for everyone, plus dedicated Bootcamp and Intern tracks
- Ranking System: Compete with peers through XP and rank progression
- Payment Integration: Earn monetary rewards for completed quests
- Company Portal: Post quests and find talented developers
- Backlog Conversion: Open Paws backlog items converted to quests
- Hackathon-to-Quest: Top hackathon prototypes become platform quests
- External Clients: Companies post quests through the Company Portal
- Role-Based Access: Adventurers, Companies, and Admins
- Secure Authentication: NextAuth.js (credentials + JWT session strategy)
- Track Enforcement: API-level access control for quest track visibility
- Frontend: Next.js 15, React, TypeScript, Tailwind CSS
- UI Components: shadcn/ui with Lucide React icons
- Database: Neon (PostgreSQL) with Prisma ORM
- Authentication: NextAuth.js (Credentials Provider)
- Deployment: Vercel
- Code Review: GitHub PR-based workflow
- Communication: Discord for team coordination
- Payment Processing: Internal quest transaction pipeline (Stripe Connect planned)
- Node.js (LTS version recommended)
- npm
- Git
- Neon account (for serverless PostgreSQL)
git clone https://github.com/LarytheLord/adventurers-guild.git
cd adventurers-guildnpm installCreate a .env.local file in the root directory:
# Database
DATABASE_URL="postgresql://user:password@your-neon-host.neon.tech/neondb?sslmode=require"
DATABASE_URL_UNPOOLED="postgresql://user:password@your-neon-host-direct.neon.tech/neondb?sslmode=require"
# Authentication
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=generate-with-openssl-rand-base64-32
# Application
NEXT_PUBLIC_APP_URL=http://localhost:3000npx prisma generate
npm run devThe application will be available at http://localhost:3000
- Browse and accept quests matching their rank
- Earn XP, skill points, and monetary rewards
- Climb the ranks from F to S
- Build portfolio with real projects
- Post quests for adventurers to complete
- Access to ranked, pre-vetted talent
- Pay for completed work
- Review and approve submissions
- Manage users and quests
- Moderate the platform
- Handle disputes and escalations
- Monitor platform health
- Join the Guild: Create your adventurer profile
- Choose Quests: Browse available quests matching your skills and rank
- Accept Quest: Commit to completing a project
- Submit Work: Complete the quest via GitHub PR and submit for review
- Get Reviewed: Senior engineers review your code
- 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
- Review Work: Approve completed projects
- Pay Adventurers: Reward successful quest completion
We welcome contributions of all skill levels! Please read our CONTRIBUTING.md for detailed guidelines.
Check out our GitHub Issues for tasks categorized by difficulty (F-Rank through S-Rank).
- CONTRIBUTING.md - Contribution guidelines
- docs/contributor-onboarding.md - Contributor onboarding
- docs/ARCHITECTURE_DECISIONS.md - Architecture decisions
- FINANCIAL_MODEL.md - Revenue model
- 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.