GitBonk
GitBook-style guide

GitBonk Documentation

GitBonk is SocialFi for builders: dev profiles, repo updates, Bonk reactions, repo wars, bounties, token tips, and an AI coding assistant.

Quickstart

1

Install dependencies

Run npm install from the project root.

2

Configure environment

Copy .env.example to .env.local and fill only the services you are ready to connect.

3

Generate Prisma

Run npm run prisma:generate to prepare the ORM client.

4

Start development

Run npm run dev and open the local URL.

npm install
npm run prisma:generate
npm run dev

Authentication

The MVP supports local email sessions, Supabase GitHub OAuth when Supabase env keys are configured, and injected browser wallet login through window.ethereum.

Email session

GitHub OAuth

Wallet login

Core Features

Developer Profiles

Builder identity, GitHub links, wallets, skills, repos, bounty history, tips, and Bonk score.

Repo Wars

A battle arena where two projects compete through community Bonk votes and prize pools.

Token Tips

MVP tipping dashboard with simulated $GITBONK tx hashes and a wallet-ready UX.

AI Assistant

Chat surface and API route prepared for OpenAI integration.

API Reference

GET/api/feedReturn SocialFi feed posts with builder data.
POST/api/postsCreate a developer update.
POST/api/bonkRegister a Bonk reaction.
GET/api/bountiesList open-source bounties.
POST/api/bountiesCreate a new bounty.
GET/api/warsList active repo battles.
POST/api/wars/voteVote in a repo war.
POST/api/tipsSend a simulated $GITBONK tip.
POST/api/aiGenerate an AI assistant response.

Database

Prisma models cover User, Post, BonkReaction, Repo, Bounty, Tip, RepoWar, and Comment. The app falls back to mock data until PostgreSQL is connected.

npm run prisma:generate
npm run prisma:push

Deployment

Frontend

Deploy the Next.js app to Vercel. Set GITBONK_API_BASE_URL to the Hostinger backend URL.

Backend

Run the Node API service on Hostinger with systemd and expose the health endpoint.

vercel deploy --prod --yes
systemctl status gitbonk-api.service

Public Safety

Public uploads must include source code, docs, brand assets, and configuration examples only. Never commit real passwords, tokens, private keys, Supabase service role values, Vercel project metadata, or local environment files.

DATABASE_URL=not committed
NEXT_PUBLIC_SUPABASE_URL=not committed
NEXT_PUBLIC_SUPABASE_ANON_KEY=not committed
SUPABASE_SERVICE_ROLE_KEY=not committed
NEXT_PUBLIC_SITE_URL=not committed
OPENAI_API_KEY=not committed
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=not committed
GITBONK_API_BASE_URL=not committed