| Feature | Description |
|---|---|
| Model Rankings | Intelligence index, hallucination rates, provider stats, details |
| Release Tracking | Newest & open-source releases with download stats |
| News Aggregation | Multi-source RSS: industry / open source / hardware / funding |
| Model Comparison | Radar-chart metrics, price breakdown, monthly cost estimator |
| Source Status | Upstream availability & latency monitoring |
modeltide/
├── src/client/ # Frontend
├── src/server/ # Worker backend
├── src/shared/ # Shared types/config/i18n
├── src/styles/ # Styles
├── public/ # Static assets
├── wrangler.jsonc # Deploy config
└── package.json # Dependencies
Requires Node.js ≥ 22.
npm install
npm run dev # client + Worker API at http://localhost:3000wrangler dev for raw Worker parity (port 8787).
| Command | Description |
|---|---|
npm run dev |
Dev server (port 3000) |
npm run build |
Production build |
npm run preview |
Preview the production build |
npm run deploy |
Build and deploy to Workers |
npm run test |
Tests (Vitest) |
npm run lint |
Static analysis (oxlint) |
npm run type-check |
Type checking (tsc) |
npm run format |
Code formatting (oxfmt) |
npm run audit |
Dependency security scan |
One Worker serves static assets and the API; a cron refreshes the cache every 30 minutes.
- Fork the repository.
- (Recommended) KV: Dashboard → Workers & Pages → KV → new namespace, put its ID into
kv_namespacesinwrangler.jsonc. - (Optional)
npx wrangler secret put HF_TOKENwith a read-only HF token to raise API rate limits. - Workers & Pages → Create application → Import a repository → Save and Deploy.
| Without KV (default) | With KV (free tier suffices) | |
|---|---|---|
| Data | Direct upstream fetch per request | Tiered caching (30m / 2h / 6h) |
| Status history | In-memory only | Persistent 90-day history |
| Rate limiting | Disabled | Enabled |
KV free tier allows 1,000 writes/day (steady state uses a few hundred). Cold cache misses may briefly return 1102 under the 10 ms CPU cap; cached hits are cheap.
worker-configuration.d.ts is generated by npx wrangler types — don't edit it by hand.