Environment Variables & Configuration

.env.local Overview#

MonoForge runs completely offline out of the box with mock data for local profile editing. If you wish to enable direct GitHub 1-click push or sync capabilities, configure an .env.local file in the project root:

cp .env.example .env.local

Configuring GitHub OAuth (Optional)#

To enable authenticated 1-click GitHub commits to your profile repository:

1. Navigate to GitHub Settings > Developer Settings > OAuth Apps > New OAuth App:

• Application Name: MonoForge Local Dev
• Homepage URL: http://localhost:3000
• Authorization callback URL: http://localhost:3000/api/auth/callback/github

1. Click Register application.
2. Generate a new client secret and copy both Client ID and Client Secret.
3. Add them to your .env.local:

GITHUB_ID=your_client_id_here
   GITHUB_SECRET=your_client_secret_here
   NEXTAUTH_URL=http://localhost:3000
   NEXTAUTH_SECRET=generate_with_openssl_rand_base64_32

Environment Variables Reference#