api

Mosque.API — REST API

REST service for the Mosque.API platform. Provides mosque directory, search, prayer times, events, capacity, reviews, and more.

Run locally

npm install
npm run dev

API: http://localhost:3001

• Health: GET /health
• OpenAPI: GET /openapi.json
• Docs: docs.mosque.api

Environment

Variable	Description
PORT	Server port (default 3001)

Tests

• Integration: Health, OpenAPI, mosques CRUD, search, nearby, pagination, prayer-times, events, capacity, imams, webhooks, analytics; edge cases: 404 (not-found id), 400 (validation, empty body, invalid JSON).
• Unit-style: Response shape (list meta, single mosque, donation-info, error shape).

npm test

Uses Node's built-in test runner and supertest. Tests import the Express app (no server listen).

Project status

See apps/api/TODO.md for implementation tasks. Endpoints are stubbed; database, auth, and business logic are pending.

Monorepo

• Root README
• Master TODO