Troubleshooting & Frequently Asked Questions

Port 3000 Already in Use#

If port 3000 is occupied by another process when starting pnpm dev:

Option A: Specify a custom port#

pnpm dev -p 3001

Option B: Free port 3000 on Windows#

Get-Process -Id (Get-NetTCPConnection -LocalPort 3000).OwningProcess | Stop-Process -Force

Option C: Free port 3000 on macOS/Linux#

lsof -ti:3000 | xargs kill -9

Clearing Next.js Turbopack Cache#

If encountering stale page bundles or persistent build anomalies, delete the local build cache:

# Windows PowerShell
Remove-Item -Recurse -Force .next

# macOS / Linux
rm -rf .next

Then re-run pnpm dev or pnpm build.

Git CRLF Line Ending Warnings#

If Git warns LF will be replaced by CRLF the next time Git touches it:

git config core.autocrlf false

GitHub OAuth Redirect URI Mismatch#

When setting up GitHub OAuth, ensure your callback URL in GitHub developer settings matches your local server port:

• Local Development: http://localhost:3000/api/auth/callback/github
• Production: https://monoforge-studio.vercel.app/api/auth/callback/github

Frequently Asked Questions#

Is MonoForge completely free?#

Yes. MonoForge is 100% free and open-source under the MIT license.

Do I need to create an account?#

No. MonoForge requires zero user accounts. All state lives client-side in your browser's localStorage.

Why do some animated SVGs not work on GitHub?#

GitHub Camo strips all <script> and <foreignObject> tags. MonoForge SVGs use pure CSS @keyframes and are verified to survive Camo sanitization.