How rishav9142/shortiq works
ShortIQ is a full-stack link-shortening and click-analytics platform. Users authenticate with Google or as guests, create and manage links in the dashboard, then visitors resolve aliases through the redirect endpoint; click context is queued and persisted asynchronously for dashboard analytics. The graph follows the excerpted server routes and module references. Analytics presentation, schema details, and documented capabilities are retained where supported; relationships stated only in the README are marked with README evidence.
Main entry points: server.ts HTTP API and redirects · index.ts Database access · App.tsx Auth app · Dashboard.tsx Link dashboard
Components 19
Client experience
- Auth app
src/App.tsx - Link dashboard
src/components/Dashboard.tsx - Analytics view
src/components/AnalyticsView.tsx
API workflows
- HTTP API and redirects
server.ts
Identity and infrastructure
- Firebase client auth
src/lib/firebase.ts - Token verification
src/middleware/auth.ts - Firebase Admin auth
src/lib/firebase-admin.ts - Rate limiting
src/middleware/rateLimit.ts - Redis adapter
src/lib/redis.ts - Redis cache
- Structured logging
src/lib/logger.ts
Persistence and analytics
- User persistence
src/db/users.ts - Database access
src/db/index.ts - Postgres schema
src/db/schema.ts - PostgreSQL
- Analytics queue
src/lib/queue.ts - Click events
src/db/schema.ts
Other components
- User
- Link visitor
Connections 25
- User → Auth app: starts session
src/App.tsx - Auth app → Firebase client auth: uses auth
src/App.tsx - Auth app → Link dashboard: renders
src/App.tsx - Auth app → HTTP API and redirects: syncs identity
src/App.tsx - Link dashboard → HTTP API and redirects: manages links
src/components/Dashboard.tsx - Link dashboard → Analytics view: renders
src/components/Dashboard.tsx - Link dashboard → Firebase client auth: uses auth
src/components/Dashboard.tsx - Link visitor → HTTP API and redirects: requests alias
README.md - HTTP API and redirects → Token verification: protects routes
server.ts - HTTP API and redirects → Rate limiting: limits requests
server.ts - Token verification → Firebase Admin auth: verifies token
src/middleware/auth.ts - HTTP API and redirects → User persistence: syncs and looks up
server.ts - User persistence → Database access: queries
src/db/users.ts - HTTP API and redirects → Database access: reads and writes
server.ts - Database access → Postgres schema: uses tables
src/db/index.ts - Database access → PostgreSQL: persists
README.md - HTTP API and redirects → Redis adapter: caches aliases
server.ts - Rate limiting → Redis adapter: uses store
src/middleware/rateLimit.ts - Redis adapter → Redis cache: connects to
src/lib/redis.ts - HTTP API and redirects → Analytics queue: enqueues clicks
server.ts - Analytics queue → Database access: persists events
src/lib/queue.ts - HTTP API and redirects → Structured logging: records events
server.ts - HTTP API and redirects → Click events: aggregates clicks
server.ts - Analytics queue → Click events: writes click rows
src/lib/queue.ts - Analytics view → HTTP API and redirects: requests analytics