Getting Started

Requirements

  • Node.js 22 or newer

  • pnpm (via Corepack is fine)

  • A Google AI Studio / Gemini API key for live scoring

  • Optional GitHub token for higher API rate limits when fetching issues

Clone and install

git clone https://github.com/dev-centr/fixnow-dev.git
cd fixnow-dev
corepack enable
pnpm install

Environment

Create a .env file in the repository root:

GOOGLE_GENERATIVE_AI_API_KEY=YOUR_API_KEY
GITHUB_TOKEN=YOUR_GH_TOKEN

Without GOOGLE_GENERATIVE_AI_API_KEY, value scoring falls back to a neutral placeholder score. Without GITHUB_TOKEN, public GitHub issue fetches still work subject to anonymous rate limits.

Development

pnpm dev

Production build

pnpm build
pnpm start

Deployment is configured for Netlify (netlify.toml). The stack is SolidStart (Vinxi) with Tailwind CSS v4.

First registration

  1. Open the app and go to Register.

  2. Paste a GitHub issue URL such as https://github.com/owner/repo/issues/123.

  3. Submit — the server fetches issue metadata, runs AI scoring, and returns the evaluation payload.

Persistence is still evolving; see API Reference for current behavior.