Open source

FirstFinder is yours to build on.

Every line of this app is public, and free to read, run, fork, and improve. It's built and paid for by one collector, which means the fastest way to get the feature you want is often to help build it — and the second fastest is to say clearly what's missing.

Write some code

The whole app is a Next.js and Supabase project you can clone and run locally in about ten minutes. Issues labeled good first issue are scoped small on purpose.

Read the contributing guide

Report a bug

Something not adding up in your collection? A precise bug report is worth as much as a patch: what you did, what you expected, and what you got instead.

File a bug report

Ask for a feature

Describe the collecting problem rather than the solution. The Roadmap page shows what's already planned, and what's deliberately ruled out.

Suggest a feature

Test it on a real collection

Rare books, comics, cards, memorabilia — real inventories break software in ways sample data never does. The odd edge case in your shelf is genuinely useful.

Improve the docs

If the setup steps didn't work on your machine, that's a bug in the documentation. Fixing one confusing paragraph helps more people than it looks like.

See what's documented

Help pay for it

Hosting, storage, the database, and every AI identification come out of one person's pocket so the app can stay free. Any donation keeps it that way.

Buy me a coffee

Ready for someone to pick up

Read straight from GitHub, so this is what's genuinely open right now.

Good first issues

Small, self-contained, and safe to get wrong the first time.

Checking GitHub…

Help wanted

Bigger pieces that are scoped and waiting on someone with time.

Checking GitHub…

Run it on your own machine

You'll need Node 20.9 or newer and a free Supabase project. Paste supabase/schema.sql into Supabase's SQL editor to create the database, then:

git clone https://github.com/dchung8811/FirstFinder.git
cd FirstFinder
npm install
cp .env.example .env.local   # add your Supabase URL and anon key
npm run dev
Full setup walkthrough
The license, in plain words

FirstFinder is released under the GNU AGPL v3. Use it, study it, change it, run your own copy for your own shelf — all fine. The one condition: if you run a modified version as a service other people can reach, you have to publish your changes too. That's what keeps this app, and anything built from it, open for collectors.