How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

Karta.AD - Skill - OpenSmartRoute

Name: Karta.AD
Author: AlievAbdujalol

Imported from AlievAbdujalol/Karta.AD (AGENTS.md). Install upstream with npx skills add AlievAbdujalol/Karta.AD. Copyright stays with the author.

Karta-AD — Agent Guide

React 18 + Vite 6 + Supabase. JS in .jsx (allowJs, checkJs: false, non-strict TS). Alias @ → ./src (vite/tsconfig/vitest).

Commands (CI order: build → lint → typecheck → test)

npm run dev        # http://localhost:5173
npm run build
npm run lint       # eslint . ; fix: npm run lint:fix
npm run typecheck  # tsc --noEmit -p ./tsconfig.json (NOT jsconfig.json)
npm run test -- --run
npx vitest run <path>  # single test, e.g. src/test/utils.test.js
vercel --prod      # deploy; push to main auto-deploys

Node 20 (CI uses npm ci). Env: copy .env.example → .env.local, never commit it.

Entrypoints

src/main.jsx → src/App.jsx; map home: src/pages/Home.jsx (+ BusMap.jsx, BottomSheet.jsx, SearchBar.jsx, RoutingPanel.jsx).
Taxi passenger form: src/pages/TaxiPassenger.jsx + src/components/taxi/TaxiTariffPanel.jsx; tariffs source: src/lib/taxi.js (TARIFFS).
Driver vehicle settings: src/pages/Profile.jsx (car tab).
Shared libs: src/lib/{osrmClient,overpass,geo,searchUtils,gemini,aiAssistant}.js.

Supabase (ref `eotkmnwneivithfkweds`)

Migrations live in supabase/migrations/. After DDL run SELECT pg_notify('pgrst','reload schema'); or PostgREST serves stale schema.
In this environment the Supabase CLI token is broken (LegacyInvalidAccessTokenError): use MCP Supabase tools or Dashboard SQL Editor for DB work, not supabase db query.
Never disable RLS for convenience. Never put SUPABASE_SERVICE_ROLE_KEY in frontend (server-only).
Keys: anon key is sb_publishable_…; service_role stays in server env.

Taxi vs Delivery — do not mix

Two separate systems:

In-app taxi/delivery: taxi_orders (category: delivery|courier), extras in TaxiTariffPanel, price via calcPrice + priceSurcharge in src/lib/taxi.js (mirror of DB RPC).
Shop delivery: delivery_orders + Edge Function supabase/functions/delivery-api/index.ts + SDK packages/delivery/.
Delivery statuses, GPS, webhooks, RLS rules, security: authoritative source is KARTA_AD_DELIVERY_SPEC.md — do not duplicate it here.

Map / routing / search

Real Leaflet map only (BusMap.jsx); never a static image or second map system.
Routing: src/lib/osrmClient.js; POIs: fetchOverpass in src/lib/overpass.js (has fallback URLs); Nominatim needs User-Agent: KartaAD/1.0 header.
Search bias: pass mapCenter into smartSearch/searchAll (src/lib/searchUtils.js).

Gemini AI

Key format is AQ.… (not AIza…); model gemini-3.6-flash; endpoint v1 (not v1beta).
Always send thinkingConfig: { thinkingBudget: 0 } and filter !p.thought parts.
.env.example model comment is stale — trust this file.

Lint

unused-imports/no-unused-imports is error; prefix intentionally unused vars/args with _. react/prop-types off.

Git-коммиты

Conventional Commits, проверяет hook .githooks/commit-msg (включается автоматически при npm install через prepare; вручную — npm run hooks:install).

Формат: тип[(область)]: описание. Типы: feat fix chore refactor test docs perf ci build style revert security.
Примеры: feat(taxi): заказ водителю из попапа, fix(ai): кнопка чата не перекрывает панель, security(ai-proxy): платные модели только с серверного разрешения.
Неконвенциональные сообщения (напр. авто-коммиты 0.0.0.0.15.x) hook нормализует в chore: (тесты/доки/CI — по индексированным файлам); неизвестный тип (bugfix:) отклоняет. Строгий режим: KARTA_STRICT_COMMITS=1.
Перед работой проверяй git status: не оставляй незакоммиченное — авто-коммиты внешних инструментов сметают всё грязное.

Docs

SUPABASE.md — schema/RLS/realtime details.
KARTA_AD_DELIVERY_SPEC.md — delivery platform spec (single source; deleted duplicates are intentional — reference it, don't recreate).

Install Karta.AD and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "alievabdujalol-karta-ad-karta-ad", "kind": "skill", "name": "Karta.AD", "description": "React 18 + Vite 6 + Supabase. JS in `.jsx` (`allowJs`, `checkJs: false`, non-strict TS). Alias `@` → `./src` (vite/tsconfig/vitest).", "publisher": "AlievAbdujalol", "version": "1.0.0", "capabilities": { "domains": [ "customer_support", "coding" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "React 18 + Vite 6 + Supabase. JS in `.jsx` (`allowJs`, `checkJs: false`, non-strict TS). Alias `@` → `./src` (vite/tsconfig/vitest)." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/AlievAbdujalol/Karta.AD", "path": "AGENTS.md", "ref": "0ad54d8ad47cc840492e71664c3423b462620cb1", "url": "https://github.com/AlievAbdujalol/Karta.AD/blob/0ad54d8ad47cc840492e71664c3423b462620cb1/AGENTS.md", "key": "AlievAbdujalol/Karta.AD/AGENTS.md" } }, "instructions": "# Karta-AD — Agent Guide\n\nReact 18 + Vite 6 + Supabase. JS in `.jsx` (`allowJs`, `checkJs: false`, non-strict TS). Alias `@` → `./src` (vite/tsconfig/vitest).\n\n## Commands (CI order: build → lint → typecheck → test)\n\n```bash\nnpm run dev # http://localhost:5173\nnpm run build\nnpm run lint # eslint . ; fix: npm run lint:fix\nnpm run typecheck # tsc --noEmit -p ./tsconfig.json (NOT jsconfig.json)\nnpm run test -- --run\nnpx vitest run <path> # single test, e.g. src/test/utils.test.js\nvercel --prod # deploy; push to main auto-deploys\n```\n\nNode 20 (CI uses `npm ci`). Env: copy `.env", "cost": { "context_tokens": 963 } }

Karta.AD

About

Karta-AD — Agent Guide

Commands (CI order: build → lint → typecheck → test)

Entrypoints

Supabase (ref `eotkmnwneivithfkweds`)

Taxi vs Delivery — do not mix

Map / routing / search

Gemini AI

Lint

Git-коммиты

Docs

Install Karta.AD and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews

About

Karta-AD — Agent Guide

Commands (CI order: build → lint → typecheck → test)

Entrypoints

Supabase (ref eotkmnwneivithfkweds)

Taxi vs Delivery — do not mix

Map / routing / search

Gemini AI

Lint

Git-коммиты

Docs

Install Karta.AD and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews

Supabase (ref `eotkmnwneivithfkweds`)