How sonal-wadkar/url-shortener works
Linkly’s main flow is browser authentication, then creating and managing short links in a protected dashboard; opening a short link triggers backend redirect and click tracking. README documents the backend API, JWT security, and MySQL persistence, but backend source excerpts were not provided, so those internals are represented at documented subsystem level and their connections cite the README.
Main entry points: api.js REST client · AppRouter.jsx Page routing · DashboardLayout.jsx Link dashboard · UrlMappingController.java URL management API
Components 21
React frontend
- App bootstrap
url-shortner-frontend/src/main.jsx - Page routing
url-shortner-frontend/src/AppRouter.jsx - Landing page
url-shortner-frontend/src/components/LandingPage.jsx - Login and register
url-shortner-frontend/src/components/LoginPage.jsx - Link dashboard
url-shortner-frontend/src/components/Dashboard/DashboardLayout.jsx - Create short link
url-shortner-frontend/src/components/Dashboard/CreateNewShorten.jsx - Link list and analytics
url-shortner-frontend/src/components/Dashboard/ShortenItem.jsx - Dashboard queries
url-shortner-frontend/src/hooks/useQuery.js - REST client
url-shortner-frontend/src/api/api.js
Spring Boot API
- Authentication API
short/src/main/java/com/example/demo/controller/AuthController.java - URL management API
short/src/main/java/com/example/demo/controller/UrlMappingController.java - Short-link redirect
short/src/main/java/com/example/demo/controller/RedirectController.java - URL business logic
short/src/main/java/com/example/demo/service/UrlMappingService.java - User services
short/src/main/java/com/example/demo/service/UserService.java
Link and analytics data
- URL mappings
short/src/main/java/com/example/demo/models/UrlMapping.java - Click events
short/src/main/java/com/example/demo/models/ClickEvent.java - MySQL database
Authentication
- JWT token state
url-shortner-frontend/src/contextApi/ContextApi.jsx - Route guard
url-shortner-frontend/src/PrivateRoute.jsx - JWT security
short/src/main/java/com/example/demo/security/jwt/JwtAuthenticationFilter.java
Other components
- Browser user
Connections 27
- Browser user → App bootstrap: uses
README.md - App bootstrap → Page routing: renders
url-shortner-frontend/src/main.jsx - Page routing → Landing page: routes to
url-shortner-frontend/src/AppRouter.jsx - Page routing → Login and register: routes to
url-shortner-frontend/src/AppRouter.jsx - Page routing → Link dashboard: routes to
url-shortner-frontend/src/AppRouter.jsx - Page routing → Route guard: guards
url-shortner-frontend/src/AppRouter.jsx - Route guard → JWT token state: checks
url-shortner-frontend/src/PrivateRoute.jsx - Login and register → REST client: calls
url-shortner-frontend/src/components/LoginPage.jsx - Login and register → JWT token state: updates token
url-shortner-frontend/src/components/LoginPage.jsx - REST client → Authentication API: REST requests
README.md - Authentication API → JWT security: issues JWT
README.md - Link dashboard → Dashboard queries: loads data
url-shortner-frontend/src/components/Dashboard/DashboardLayout.jsx - Dashboard queries → REST client: requests
url-shortner-frontend/src/hooks/useQuery.js - Link dashboard → Create short link: opens form
url-shortner-frontend/src/components/Dashboard/DashboardLayout.jsx - Create short link → REST client: submits link
url-shortner-frontend/src/components/Dashboard/CreateNewShorten.jsx - Link dashboard → Link list and analytics: renders
url-shortner-frontend/src/components/Dashboard/DashboardLayout.jsx - Link list and analytics → REST client: fetches analytics
url-shortner-frontend/src/components/Dashboard/ShortenItem.jsx - REST client → URL management API: REST requests
README.md - URL management API → URL business logic: delegates
README.md - Short-link redirect → URL business logic: resolves code
README.md - URL business logic → URL mappings: manages
README.md - URL business logic → Click events: records clicks
README.md - URL mappings → MySQL database: persists via JPA
README.md - Click events → MySQL database: persists via JPA
README.md - Short-link redirect → Browser user: redirects
README.md - URL management API → User services: user-specific access
README.md - JWT security → URL management API: secures endpoints
README.md