BetterDev is a chain-agnostic reputation and coordination protocol for real-world engineering communities.
Members receive a Community ID, build portable reputation through verified participation, and use the Passport layer to prove contribution across meetups and future ecosystem opportunities.
Built with love ❤️ for engineers who prefer real connections over passive feeds.
BetterDev helps engineers move from passive online networking into verified real-world participation. Members join local chapters, receive a Community ID, log in with email, and build reputation through meetups, contributions, and community coordination.
BetterDev is Arbitrum-first, not Arbitrum-only — identity and reputation belong to the member, not to a single wallet or chain.
Full protocol design: docs/protocol-architecture.md
- Community ID — portable member identity and invite links
- Member login — email verification and profile at
/login - BetterDev Passport — on-chain credential and reputation layer
- Meetup participation — verified attendance and reputation events
- Builder Circles — fair group coordination powered by Chainlink VRF (roadmap)
- Identity — Community ID, Passport, multi-chain wallet registry (protocol design)
- Reputation — attendance, profile, referrals, publications
- Coordination — Builder Circles and meetup tooling
| Area | Stack |
|---|---|
| App | Next.js 15, React 19, Tailwind CSS |
| Chain | Arbitrum Sepolia, ethers.js, Hardhat |
| Randomness | Chainlink VRF |
| Storage | Google Sheets (MVP) · optional Supabase |
Smart contracts: BetterDevPassport, ReputationRegistry, MeetupRegistry, BuilderCircleVRF
For local development you need Node.js 20+ and a copy of the environment template.
git clone https://github.com/BetterDevOrg/protocol.git
cd protocol
npm install
cp .env.example .env.local
# Fill in .env.local — never commit this file
npm run dev| Command | Purpose |
|---|---|
npm run dev |
Development server |
npm run build |
Production build |
npm run lint |
ESLint |
npm run contracts:compile |
Compile Solidity |
npm run contracts:test |
Run contract tests |
npm run contracts:deploy:sepolia |
Deploy to Arbitrum Sepolia |
Environment variables are listed in .env.example. Do not commit secrets (private keys, API tokens, session secrets).
src/app/ Next.js routes and API
src/components/ UI components
src/lib/ Shared logic
contracts/ Solidity protocol
scripts/ Deploy and integration scripts
docs/ Protocol and project documentation
| Document | Description |
|---|---|
| Protocol Architecture | Identity model, on/off-chain boundary, roadmap |
| Internship Projects | Contributor tracks for interns and newcomers |
| Contributing | How to contribute |
| Governance | Maintainers and decision-making |
| Code of Conduct | Community standards |
| Security | Responsible disclosure |
.env.example |
Environment variable template (placeholders only) |
| Maintainer | GitHub |
|---|---|
| Frankeze | @FrankezeCode |
| Ruth | @BetterRuth |
We welcome contributions. See CONTRIBUTING.md for setup and pull request guidelines.
Look for issues labeled good first issue on GitHub Issues. See Internship Projects for structured tracks.
If you discover a security issue, do not open a public GitHub issue. See SECURITY.md for responsible disclosure.
MIT © BetterDev
- Website: betterdev.live
- Member login: betterdev.live/login
- Repository: github.com/BetterDevOrg/protocol
- Issues: github.com/BetterDevOrg/protocol/issues