Developer Docs

Build & Contribute to
aifindr.org

Open-source AI tools directory. Self-host it, fork it, or contribute tools and code. Built with Nuxt 3 and deployed on Cloudflare Pages.

★ View on GitHub Quick Start ↓ Submit a Tool
Nuxt 3 Cloudflare Pages TypeScript Vue 3 MIT License Open Source
Get Started

Quick Start

Run aifindr.org locally in under 5 minutes.

1
Clone the repository

Fork or clone the repo to your local machine.

git clone https://github.com/kbmjj123/aifindr.org.git cd aifindr.org
2
Install dependencies

Requires Node.js 18+. Uses npm as the package manager.

npm install
3
Configure environment

Copy the example env file and fill in your values. See the Environment Variables section below.

cp .env.example .env # Then edit .env with your config values
4
Start the dev server

The site runs at localhost:3000 by default.

npm run dev # → http://localhost:3000
5
Deploy to Cloudflare Pages

The project is pre-configured for Cloudflare Pages via wrangler.toml.

npm run build npx wrangler pages deploy .output/public
Architecture

Project Structure

Key directories and what they contain.

aifindr.org/
  components/  ── Vue UI components
  composables/  ── shared logic hooks
  content/tools/  ── tool Markdown files (one per tool)
    image/  ── Image & Design tools
    writing/  ── Writing & Content tools
    video/  ── Video & Animation tools
    ── ... 12 categories total
  docs/  ── this GitHub Pages site
  pages/  ── Nuxt route pages
  server/  ── API routes
  schema/  ── tool data schema / validation
  nuxt.config.ts  ── Nuxt configuration
  wrangler.toml  ── Cloudflare Pages config
  .env.example  ── environment variable template
Configuration

Environment Variables

Copy .env.example to .env and fill in these values.

Variable Description Required
NUXT_PUBLIC_SITE_URL Your deployed site URL Required
GITHUB_TOKEN GitHub token for PR automation Required
GITHUB_REPO Target repo for tool submissions (owner/repo) Required
NUXT_PUBLIC_GA_ID Google Analytics measurement ID Optional
Contributing

How to Contribute

Two ways to contribute — submit tools or improve the codebase.

🛠 Submit a Tool

Add a Markdown file to content/tools/[category]/, fill in the frontmatter, and open a Pull Request. Approved tools get 3 free dofollow backlinks.

Submission Guide →
💻 Improve the Code

Bug fixes, new features, UI improvements — all welcome. Open an Issue first to discuss larger changes before submitting a PR.

Open an Issue →
⭐ Star the Repo

The simplest contribution. Starring the repo helps more people discover the project and signals to search engines that the project is active.

Star on GitHub →
🔗 Add a Backlink

Add a footer link to aifindr.org on your site and unlock free access to premium features. One line of HTML, permanent value.

Learn More →