Documentation

Track applications and keep one resume template per job type. The name at the top of the sidebar is the current template. Apply, Jobs, Progress, Calendar, and Resumes follow that pick.

Pages

Apply creates the job and the resume. Tailored files are named First_Last_Company_Resume.pdf. The Resumes page shows the company name.

Password lock

The app stays open unless you set AUTH_SECRET.

AUTH_SECRET signs the session cookie. Login asks for AUTH_PASSWORD (or AUTH_SECRET if that is unset). Change either by editing env and restarting. There is no password row in the database.

Local vs cloud

Both can run at the same time on the same data.

A save on your laptop writes to Turso and Drive, then updates the local cache. The hosted app reads those cloud copies. It does not keep files on the server.

Connect Drive once on this Documents page. That Google login is stored in Turso, so Vercel can keep writing files without signing in again.

Jobless Assets/ and Database/ are not in git. A new clone copies samples/assets/ into Jobless Assets/ only when that folder is empty. Jobs start in a new empty Database/tracker.db.

Run locally

1. Copy .env.example to .env.local.
2. Run npm install then npm run dev.
3. Open http://localhost:3000.

PDF: local pdflatex if installed, otherwise TeX Live over HTTP.

You only need a Gemini key to use Apply. Drive and Turso are optional on a laptop. They are required if you want the Vercel deploy to keep jobs and files.

Vercel

1. Import the repo in Vercel.
2. Set the same env names as .env.example. You need Gemini, Turso, and Drive for a hosted app that keeps data.
3. Add https://jobless.ibrahimarain.com/api/drive/callback as an OAuth redirect URI, and set GOOGLE_REDIRECT_URI in Vercel to that same URL.
4. Deploy.

API keys

Copy .env.example to .env.local, or set the same names in Vercel. Restart the app after you change keys.

Not keys: AI_MODEL, AI_MODEL_FALLBACKS, ASSETS_DIR, LATEX_COMPILE_URL.

Gemini

Key: GOOGLE_GENERATIVE_AI_API_KEY.

1. Open Google AI Studio.
2. Sign in with a Google account.
3. Create an API key.
4. Paste it as GOOGLE_GENERATIVE_AI_API_KEY.
5. Restart the app.

Google Drive

Keys: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET. Optional: GOOGLE_REDIRECT_URI.

Google requires a one-time sign-in. After that, files live in a Drive folder named Jobless Assets.

1. Open Google Cloud Console.
2. Create a project or select one.
3. Enable the Google Drive API (APIs and Services, then Enable APIs).
4. OAuth consent screen: External is fine for personal use. Add your email as a test user.
5. Create credentials: OAuth client ID, application type Web application.
6. Authorized redirect URIs — add every place you might click Connect:
   • http://localhost:3000/api/drive/callback
   • https://jobless.ibrahimarain.com/api/drive/callback
7. Copy the client ID and secret into .env.local and Vercel.
8. Set GOOGLE_REDIRECT_URI to the callback for the site you are connecting from (localhost for npm run dev, your domain on Vercel).
9. Restart. Open Documents and click Connect Drive. Sign in with Google once.

If Turso is already set and you connected from local, the hosted app reuses that token. You do not connect twice.

Turso

Keys: TURSO_DATABASE_URL, TURSO_AUTH_TOKEN. With these set, the app uses Turso as the database locally and on Vercel. An existing Database/tracker.db is copied into Turso once.

1. Open Turso and create an account.
2. Create a database.
3. Copy the URL and auth token into .env.local and Vercel env.