How kushelwho/url-shortener works
This is a full-stack URL shortener: React provides registration/login, a protected dashboard, link creation and click charts; Spring Boot exposes authentication, shortening, redirect and analytics APIs backed by persistent user, mapping and click-event data. The principal flow is authenticated URL creation, followed by public short-link resolution and click recording. Edges reflect shown calls and README-documented interactions; some frontend API wiring and security configuration were not sampled, so those links are omitted or marked as documented.
Main entry points: AppRouter.jsx Page routing · UserService.java User service · UrlMappingController.java URL management API · UrlMappingService.java URL and analytics service
Components 24
React interface
- React app
url-shortener-react/src/App.jsx - Page routing
url-shortener-react/src/AppRouter.jsx - Token context
url-shortener-react/src/contextApi/ContextApi.jsx - Login and register
url-shortener-react/src/components/RegisterPage.jsx - Dashboard
url-shortener-react/src/components/Dashboard/DashboardLayout.jsx - Link actions
url-shortener-react/src/components/Dashboard/ShortenItem.jsx - Click charts
url-shortener-react/src/components/Dashboard/Graph.jsx - Dashboard queries
url-shortener-react/src/hooks/useQuery.js - HTTP client
url-shortener-react/src/api/api.js
Authentication
- Authentication API
url-shortener-sb/src/main/java/com/url/shortener/controller/AuthController.java - User service
url-shortener-sb/src/main/java/com/url/shortener/service/UserService.java - JWT utilities
url-shortener-sb/src/main/java/com/url/shortener/security/jwt/JwtUtils.java - JWT filter
url-shortener-sb/src/main/java/com/url/shortener/security/jwt/JwtAuthenticationFilter.java
Shortening and analytics
- URL management API
url-shortener-sb/src/main/java/com/url/shortener/controller/UrlMappingController.java - URL and analytics service
url-shortener-sb/src/main/java/com/url/shortener/service/UrlMappingService.java - Short-link redirect
url-shortener-sb/src/main/java/com/url/shortener/controller/RedirectController.java
Persistent data
- User repository
url-shortener-sb/src/main/java/com/url/shortener/repository/UserRepository.java - URL repository
url-shortener-sb/src/main/java/com/url/shortener/repository/UrlMappingRepository.java - Click repository
url-shortener-sb/src/main/java/com/url/shortener/repository/ClickEventRepository.java - User records
url-shortener-sb/src/main/java/com/url/shortener/models/User.java - URL mappings
url-shortener-sb/src/main/java/com/url/shortener/models/UrlMapping.java - Click events
url-shortener-sb/src/main/java/com/url/shortener/models/ClickEvent.java
Other components
- Visitor
- Original destination
Connections 27
- Visitor → Page routing: opens pages
url-shortener-react/src/AppRouter.jsx - React app → Page routing: selects app
- Page routing → Login and register: routes to
url-shortener-react/src/AppRouter.jsx - Page routing → Dashboard: routes to
url-shortener-react/src/AppRouter.jsx - Page routing → Visitor: serves redirect page
- Dashboard → Dashboard queries: fetches data
url-shortener-react/src/components/Dashboard/DashboardLayout.jsx - Dashboard → Click charts: renders chart
url-shortener-react/src/components/Dashboard/DashboardLayout.jsx - Link actions → HTTP client: sends requests
url-shortener-react/src/components/Dashboard/ShortenItem.jsx - Dashboard queries → HTTP client: requests data
url-shortener-react/src/hooks/useQuery.js - Token context → Login and register: shares token
- Visitor → Authentication API: registers or logs in
README.md - Authentication API → User service: delegates
url-shortener-sb/src/main/java/com/url/shortener/controller/AuthController.java - User service → User repository: reads and saves
url-shortener-sb/src/main/java/com/url/shortener/service/UserService.java - User service → JWT utilities: creates token
url-shortener-sb/src/main/java/com/url/shortener/service/UserService.java - JWT filter → JWT utilities: validates token
url-shortener-sb/src/main/java/com/url/shortener/security/jwt/JwtAuthenticationFilter.java - HTTP client → URL management API: calls endpoints
README.md - Visitor → URL management API: requests shortening
README.md - URL management API → User service: resolves user
url-shortener-sb/src/main/java/com/url/shortener/controller/UrlMappingController.java - URL management API → URL and analytics service: delegates
url-shortener-sb/src/main/java/com/url/shortener/controller/UrlMappingController.java - URL and analytics service → URL repository: reads and saves
url-shortener-sb/src/main/java/com/url/shortener/service/UrlMappingService.java - URL and analytics service → Click repository: records and queries
url-shortener-sb/src/main/java/com/url/shortener/service/UrlMappingService.java - Short-link redirect → URL and analytics service: resolves short code
url-shortener-sb/src/main/java/com/url/shortener/controller/RedirectController.java - Visitor → Short-link redirect: opens short link
README.md - Short-link redirect → Original destination: redirects to
README.md - User repository → User records: persists
url-shortener-sb/src/main/java/com/url/shortener/repository/UserRepository.java - URL repository → URL mappings: persists
url-shortener-sb/src/main/java/com/url/shortener/repository/UrlMappingRepository.java - Click repository → Click events: persists
url-shortener-sb/src/main/java/com/url/shortener/repository/ClickEventRepository.java