iHildy · iHildy · Aug 16, 2025 · Aug 15, 2025 · Aug 15, 2025 · Aug 15, 2025
diff --git a/.env.example b/.env.example
@@ -2,11 +2,15 @@
 DATABASE_URL="postgresql://postgres:postgres@127.0.0.1:54322/postgres"
 
 # GitHub App Integration
+# For local dev, you can often use a raw PEM string for the private key.
+# For server environments (Vercel, Docker), provide the key as a Base64-encoded string - see README for details.
+# The app will handle decoding automatically.
 NEXT_PUBLIC_GITHUB_APP_ID="123456"
 GITHUB_APP_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----\nYOUR_PRIVATE_KEY_HERE\n-----END RSA PRIVATE KEY-----"
 GITHUB_APP_WEBHOOK_SECRET="your-github-app-webhook-secret-here"
 GITHUB_APP_CLIENT_ID="Iv1.your-client-id-here"
 GITHUB_APP_CLIENT_SECRET="your-client-secret-here"
+GITHUB_APP_CALLBACK_URL="http://localhost:3000/api/auth/callback/github"
 NEXT_PUBLIC_GITHUB_APP_NAME="jules-task-queue"
 
 # Cron job verification token (for Firebase you also need to add this in ./functions/.env as well)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -12,13 +12,13 @@ There are many ways to contribute, from writing tutorials or blog posts, improvi
 
 ### Reporting Bugs
 
-- **Ensure the bug was not already reported** by searching on GitHub under [Issues](https://github.com/iHildy/jules-task-queue/issues).
-- If you're unable to find an open issue addressing the problem, [open a new one](https://github.com/iHildy/jules-task-queue/issues/new?assignees=&labels=bug&template=bug_report.md&title=). Be sure to include a **title and clear description**, as much relevant information as possible, and a **code sample** or an **executable test case** demonstrating the expected behavior that is not occurring.
+- **Ensure the bug was not already reported** by searching on GitHub under [Issues](https://github.com/ihildy/jules-task-queue/issues).
+- If you're unable to find an open issue addressing the problem, [open a new one](https://github.com/ihildy/jules-task-queue/issues/new?assignees=&labels=bug&template=bug_report.md&title=). Be sure to include a **title and clear description**, as much relevant information as possible, and a **code sample** or an **executable test case** demonstrating the expected behavior that is not occurring.
 
 ### Suggesting Enhancements
 
-- **Ensure the enhancement was not already suggested** by searching on GitHub under [Issues](https://github.com/iHildy/jules-task-queue/issues).
-- If you're unable to find an open issue, [open a new one](https://github.com/iHildy/jules-task-queue/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=). Provide a clear description of the enhancement and its potential benefits.
+- **Ensure the enhancement was not already suggested** by searching on GitHub under [Issues](https://github.com/ihildy/jules-task-queue/issues).
+- If you're unable to find an open issue, [open a new one](https://github.com/ihildy/jules-task-queue/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=). Provide a clear description of the enhancement and its potential benefits.
 
 ### Pull Requests
 
@@ -74,7 +74,7 @@ Ready to start coding? Here's how to get the project running locally.
 
     You will need to set `DATABASE_URL` to point to your local Docker container:
     `DATABASE_URL="postgresql://postgres:postgres@localhost:5432/postgres"`
-    You will also need to [create a GitHub App](https://github.com/iHildy/jules-task-queue/blob/main/GITHUB_APP_SETUP.md) and fill in the corresponding `GITHUB_APP_*` variables.
+    You will also need to [create a GitHub App](https://github.com/ihildy/jules-task-queue/blob/main/GITHUB_APP_SETUP.md) and fill in the corresponding `GITHUB_APP_*` variables.
 
 5.  **Run Database Migrations:**
 

diff --git a/FIREBASE.md b/FIREBASE.md
@@ -65,7 +65,7 @@ You can either fork the repository or clone it directly:
 
 ```bash
 # Clone the repository
-git clone https://github.com/iHildy/jules-task-queue.git
+git clone https://github.com/ihildy/jules-task-queue.git
 cd jules-task-queue
 
 # Install dependencies
@@ -632,7 +632,7 @@ firebase functions:log --only retryTasks
 
 - **Firebase Documentation**: [firebase.google.com/docs/app-hosting](https://firebase.google.com/docs/app-hosting)
 - **Community Support**: [Firebase Discord](https://discord.gg/firebase)
-- **Project Issues**: [GitHub Issues](https://github.com/iHildy/jules-task-queue/issues)
+- **Project Issues**: [GitHub Issues](https://github.com/ihildy/jules-task-queue/issues)
 
 ## Migration from Other Platforms
 

diff --git a/GITHUB_APP_SETUP.md b/GITHUB_APP_SETUP.md
@@ -45,7 +45,7 @@ Automated task queue management for Jules interactions. Monitors issue labels an
 **Homepage URL:**
 
 ```
-https://github.com/iHildy/jules-task-queue
+https://github.com/ihildy/jules-task-queue
 ```
 
 **User authorization callback URL:**

diff --git a/README.md b/README.md
@@ -6,14 +6,14 @@
     <br />
     <a href="https://julesqueue.hildy.io/">Visit Site</a>
     ·
-    <a href="https://github.com/iHildy/jules-task-queue/issues/new?assignees=&labels=bug&template=bug_report.md&title=">Report Bug</a>
+    <a href="https://github.com/ihildy/jules-task-queue/issues/new?assignees=&labels=bug&template=bug_report.md&title=">Report Bug</a>
     ·
-    <a href="https://github.com/iHildy/jules-task-queue/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=">Request Feature</a>
+    <a href="https://github.com/ihildy/jules-task-queue/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=">Request Feature</a>
   </p>
   <p align="center">
-    <a href="https://github.com/iHildy/jules-task-queue/blob/main/LICENSE"><img src="https://img.shields.io/github/license/iHildy/jules-task-queue?style=for-the-badge" /></a>
-    <a href="https://github.com/iHildy/jules-task-queue/stargazers"><img src="https://img.shields.io/github/stars/iHildy/jules-task-queue?style=for-the-badge" /></a>
-    <a href="https://github.com/iHildy/jules-task-queue/issues"><img src="https://img.shields.io/github/issues/iHildy/jules-task-queue?style=for-the-badge" /></a>
+    <a href="https://github.com/ihildy/jules-task-queue/blob/main/LICENSE"><img src="https://img.shields.io/github/license/ihildy/jules-task-queue?style=for-the-badge" /></a>
+    <a href="https://github.com/ihildy/jules-task-queue/stargazers"><img src="https://img.shields.io/github/stars/ihildy/jules-task-queue?style=for-the-badge" /></a>
+    <a href="https://github.com/ihildy/jules-task-queue/issues"><img src="https://img.shields.io/github/issues/ihildy/jules-task-queue?style=for-the-badge" /></a>
   </p>
 </div>
 
@@ -120,7 +120,7 @@ graph TD
 
 ## 🤝 Contributing
 
-Contributions, issues, and feature requests are welcome! Feel free to check the [issues page](https://github.com/iHildy/jules-task-queue/issues).
+Contributions, issues, and feature requests are welcome! Feel free to check the [issues page](https://github.com/ihildy/jules-task-queue/issues).
 
 Please read the [**CONTRIBUTING.md**](./CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
 

diff --git a/SELF_HOSTING.md b/SELF_HOSTING.md
@@ -14,7 +14,7 @@ The easiest way to self-host is using the provided Docker Compose setup:
 ### 2. Clone the repository
 
 ```bash
-git clone https://github.com/iHildy/jules-task-queue.git
+git clone https://github.com/ihildy/jules-task-queue.git
 cd jules-task-queue
 ```
 

diff --git a/convert-to-access-token.md b/convert-to-access-token.md
diff --git a/package.json b/package.json
@@ -20,7 +20,8 @@
     "db:studio": "prisma studio",
     "type-check": "tsc --noEmit",
     "cron:run": "curl -X POST http://localhost:3000/api/cron/retry --header 'Authorization: Bearer $CRON_SECRET'",
-    "ngrok": "ngrok http 3000"
+    "ngrok": "ngrok http 3000",
+    "tree": "tree -f -I \".next|node_modules|migrations\" -L 3"
   },
   "dependencies": {
     "@icons-pack/react-simple-icons": "^13.3.0",

diff --git a/src/app/api/auth/authorize/github/route.ts b/src/app/api/auth/authorize/github/route.ts
@@ -29,6 +29,14 @@ function isValidRedirectUrl(redirectTo: string): boolean {
 }
 
 export async function GET(request: NextRequest) {
+  // Validate required env at runtime
+  if (!env.GITHUB_APP_CALLBACK_URL) {
+    logger.error("Missing GITHUB_APP_CALLBACK_URL env variable");
+    return NextResponse.json(
+      { error: "Server misconfiguration: missing callback URL" },
+      { status: 500 },
+    );
+  }
   const { searchParams } = new URL(request.url);
   const installationId = searchParams.get("installation_id");
   const redirectTo = searchParams.get("redirect_to") || "/github-app/success";