How adityajha002/niji works
NIJI is a hyperlocal marketplace discovery product: shoppers search for nearby in-stock products, while shop owners create shops and manage listings. The frontend routes users into search, product/shop views, authentication, and owner dashboards; backend APIs persist marketplace data and enqueue product enrichment; a separate search service indexes and searches products with geographic and price filters. The README documents the sync pipeline and integrations; some route and UI internals were not sampled, so those links are cited only where documented.
Main entry points: backend/server.js Express API · AppRoutes.tsx Client routing · src/server.js Search service · productRoutes.js Product API
Components 26
Shopper and owner client
- Client routing
frontend/src/routes/AppRoutes.tsx - Authentication UI
frontend/src/pages/auth/auth.tsx - Auth state
frontend/src/context/authContext.tsx - Product search UI
frontend/src/pages/search/search.tsx - Product and shop views
frontend/src/pages/product/productView.tsx - Shop management
frontend/src/pages/dashboard/dashboard.tsx - API services
frontend/src/services/productService.ts
Marketplace API
- Express API
backend/server.js - Authentication API
backend/routes/authRoutes.js - Shop API
backend/routes/shopRoutes.js - Product API
backend/routes/productRoutes.js - Search gateway
backend/routes/searchRoutes.js - Postgres data
backend/config/db.js - Image storage
backend/config/cloudinary.js - Product sync queue
backend/config/services/Queue.js - Keyword generation
backend/config/services/geminiKeywords.js
Search and indexing
- Search service
meilisearch/src/server.js - Search and indexing
meilisearch/src/services/searchProducts.js - Database reindexing
meilisearch/src/services/indexAll.js - Queue reprocessing
meilisearch/src/services/reQueue.js - Meilisearch index
meilisearch/src/config/meiliClient.js
Other components
- Shopper
- Shop owner
- Supabase Postgres
- Cloudinary
- Gemini API
Connections 35
- Shopper → Client routing: uses
frontend/src/routes/AppRoutes.tsx - Shop owner → Client routing: uses
frontend/src/routes/AppRoutes.tsx - Client routing → Product search UI: routes to
frontend/src/routes/AppRoutes.tsx - Client routing → Product and shop views: routes to
frontend/src/routes/AppRoutes.tsx - Client routing → Shop management: routes to
frontend/src/routes/AppRoutes.tsx - Client routing → Authentication UI: routes to
frontend/src/routes/AppRoutes.tsx - Authentication UI → Auth state: uses
frontend/src/pages/auth/auth.tsx - Product search UI → API services: requests search
frontend/src/services/productService.ts - Product and shop views → API services: loads listings
- Shop management → API services: manages listings
frontend/src/pages/dashboard/dashboard.tsx - API services → Express API: calls API
frontend/src/services/productService.ts - Express API → Authentication API: mounts routes
backend/server.js - Express API → Shop API: mounts routes
backend/server.js - Express API → Product API: mounts routes
backend/server.js - Express API → Search gateway: mounts routes
backend/server.js - Authentication API → Postgres data: reads and writes
backend/routes/authRoutes.js - Shop API → Postgres data: reads and writes
backend/routes/shopRoutes.js - Product API → Postgres data: reads and writes
backend/routes/productRoutes.js - Shop API → Image storage: uploads images
backend/routes/shopRoutes.js - Product API → Image storage: uploads images
backend/routes/productRoutes.js - Product API → Product sync queue: queues product
backend/routes/productRoutes.js - Express API → Product sync queue: retries queue
backend/server.js - Product sync queue → Keyword generation: generates keywords
backend/config/services/Queue.js - Product sync queue → Postgres data: persists sync state
backend/config/services/Queue.js - Keyword generation → Gemini API: requests keywords
README.md - Express API → Search service: sends indexed products
README.md - Search gateway → Search service: forwards searches
README.md - Search service → Search and indexing: dispatches search
meilisearch/src/server.js - Search service → Database reindexing: rebuilds index
meilisearch/src/server.js - Search service → Queue reprocessing: retries indexing
meilisearch/src/server.js - Search and indexing → Meilisearch index: searches index
meilisearch/src/services/searchProducts.js - Database reindexing → Meilisearch index: writes documents
meilisearch/src/services/indexAll.js - Database reindexing → Supabase Postgres: reads products
meilisearch/src/services/indexAll.js - Queue reprocessing → Meilisearch index: updates documents
meilisearch/src/services/reQueue.js - Queue reprocessing → Supabase Postgres: reads queued data
meilisearch/src/services/reQueue.js