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.

• Guild Card — Verifiable public profile showing rank, XP, skills, and completed quest history. Share on LinkedIn. Employers can verify rank programmatically.
• Gamified Ranking — Progress from F-Rank to S-Rank through real-world projects. Rank is the credential.
• Quest System — Complete authentic projects commissioned by real companies. XP multipliers for streaks.
• Two-Track Architecture — Open quests for everyone, plus dedicated Bootcamp and Intern tracks.
• Payment Integration — Earn monetary rewards for completed quests.
• Company Portal — Post quests, review applicants, and find ranked developers.
• Admin QA Layer — Submissions go through pending_admin_review before company sees them.

• External Clients — Companies post quests through the Company Portal.
• Bootcamp Track — Open Paws bootcamp students complete F/E rank quests as part of their curriculum.
• Intern Track — 20 paid interns handle D+ rank quests in squads of 3–5.

• Role-Based Access — Adventurers, Companies, and Admins with distinct permissions.
• Secure Authentication — NextAuth.js (credentials + JWT session strategy, 30-day sessions).
• Track Enforcement — API-level access control for quest track visibility.

• Node.js LTS
• npm
• Git
• A Neon account (free tier works)

git clone https://github.com/LarytheLord/adventurers-guild.git
cd adventurers-guild

npm install

Copy the example env file:

cp .env.example .env.local

Fill in the required values:

# Database — get from Neon dashboard
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 — generate with: openssl rand -base64 32
NEXTAUTH_SECRET="your-secret-here"
NEXTAUTH_URL="http://localhost:3000"

# Application
NEXT_PUBLIC_APP_URL="http://localhost:3000"

# Generate Prisma client
npx prisma generate

# Push schema to your Neon database (no migration files needed)
npm run db:push

npm run dev

The application will be available at http://localhost:3000.

F → E → D → C → B → A → S — XP thresholds determine rank. Higher rank = harder quests with bigger rewards.

1. Join the Guild — Create your adventurer profile
2. Browse Quests — Filter by rank, track, and skills
3. Claim a Quest — Commit to completing a project
4. Submit Work — Complete via GitHub PR and submit for review
5. Get Reviewed — QA review, then company approval
6. Earn Rewards — XP, rank progression, and monetary rewards
7. Build Your Guild Card — Public verifiable credential you can share

1. Register — Create your company profile
2. Post Quests — Describe the project with clear specs
3. Review Applicants — Select ranked developers
4. Approve Work — Review and accept completed submissions
5. Pay Adventurers — Rewards are distributed on approval

We welcome contributions of all skill levels! NSoC 2026 participants — this is an active program running April 15 – May 30, 2026.

Start here:

1. Read CONTRIBUTING.md for the full workflow
2. Check docs/contributor-onboarding.md for local setup
3. Pick an issue from GitHub Issues labeled by rank (F-rank = beginner-friendly)

Issues are labeled F-rank through S-rank by complexity. Good first issues are labeled good first issue.

• Discord: Join our Community
• Website: adventurersguild.vercel.app
• GitHub: LarytheLord/adventurers-guild

This project is licensed under the MIT License — see the LICENSE file for details.