Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
A local-first English and Arabic resume builder with reusable career records, independent resumes, PDF export, and application tracking.
GitHub didn't answer, so this is the saved copy from 12 h ago
Will it work on macOS?
Heads-upIt also needs 3 settings in .env (2 secret).
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/lodaq/careery.git cd careery
Node.js LTS (no version pinned), Bun
# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm) nvm install --lts curl -fsSL https://bun.sh/install | bash
Fill in secrets: NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY, CLERK_SECRET_KEY
cp .env.example .env.local
bun install
bun run dev
bun run test
Requires Node.js 20.9+ and Bun 1.4.4.
bun install
bunx playwright install chromium
NEXT_TELEMETRY_DISABLED=1 bun run dev
For remote previews, run bun run dev:https --hostname <development-hostname> and trust the development certificate on the browser's machine. For an HTTPS tunnel, set CAREERY_DEV_HOST to its exact hostname. Non-loopback HTTP requests are rejected before authentication because Clerk's secure renewal cookies require HTTPS. Generated certificates are ignored by Git.
The deployed careery-lime.vercel.app site currently uses Clerk development keys for testing. Production authentication requires an owned custom domain, verified Clerk DNS, matching production keys and production Google OAuth credentials. No custom domain is currently configured for use.
Open http://127.0.0.1:3000. The development server binds only to loopback. The /career-record page edits bilingual content with automatic saving, validation and retry. It prevents stale tabs from overwriting newer saves. The home page creates and lists Profiles; Profile editors select Career Record copies and edit them independently. Deleting a Profile moves its Resumes to Unfiled. Resume PDF downloads use /api/resumes/[id]/pdf.
/settings downloads a single JSON backup of every local store and restores one. A restore validates the file with the app's readers, replaces only the stores in the bundle, and copies the replaced files to data/backups/ first. Keep backup files private; they contain personal career information.
No reports for macOS yet.
GitManual AI Agent reads the 3 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.