​

Self-Hosting

​

Prerequisites

• Node.js 20+
• GitHub OAuth App — Create one at github.com/settings/developers
  • Set the callback URL to http://localhost:3000/api/auth/callback/github (or your production URL)

​

Environment Variables

GITHUB_CLIENT_ID=your_github_oauth_client_id
GITHUB_CLIENT_SECRET=your_github_oauth_client_secret
AUTH_SECRET=a_random_secret_string  # Generate with: openssl rand -base64 32

​

Install & Run

cd app
npm install
npm run dev

​

Production Build

cd app
npm run build
npm start

• Set the GitHub OAuth callback URL to your production domain
• Use a strong AUTH_SECRET value
• Deploy behind HTTPS

​

Architecture Notes

• Auth: NextAuth v5 with GitHub OAuth provider. Sessions use JWT strategy.
• Data: All data is fetched from GitHub via Octokit using the authenticated user’s access token. No additional database is required.
• Themes: Theme color files are fetched from GitHub and cached with 24-hour revalidation.