How lesam24/sams-toolbox works
Sam’s Toolbox is a self-hosted web app for everyday utilities. A user opens the dashboard, selects a tool, and uses its page; the URL shortener additionally creates persisted short codes and redirects visitors while counting clicks. PDF merging and reading are separate workflows, with merging delegated to a PDF utility and reading rendered through a viewer. The README also lists a QR-code generator as coming soon, so it is not represented as a working subsystem. Some client-to-API wiring is not shown in the excerpts and is marked unverified.
Main entry points: DashboardLayout.tsx Dashboard layout · app/page.tsx Tool dashboard · Sidebar.tsx Sidebar navigation · pdf-merger/page.tsx Merger page
Components 19
Dashboard and navigation
- Tool dashboard
src/app/page.tsx - Tool catalog
src/lib/tools.ts - Software shortcuts
src/lib/shortcuts.ts - Dashboard layout
src/components/layout/DashboardLayout.tsx - Sidebar navigation
src/components/layout/Sidebar.tsx - Theme toggle
src/components/layout/ThemeToogle.tsx
PDF tools
- Merger page
src/app/tools/pdf-merger/page.tsx - PDF merger UI
src/app/tools/pdf-merger/PdfMerger.tsx - PDF merge engine
src/lib/pdf.ts - Reader page
src/app/tools/pdf-reader/page.tsx - PDF reader UI
src/app/tools/pdf-reader/PdfReader.tsx - PDF viewer
src/app/tools/pdf-reader/PdfViewer.tsx
URL shortener
- Shortener page
src/app/tools/url-shortener/page.tsx - Shortener UI
src/app/tools/url-shortener/UrlShortener.tsx - URL creation API
src/app/api/urls/route.ts - Short-code redirect
src/app/[code]/route.ts
URL persistence
- Short URL table
src/lib/db/schema.ts
Other components
- Tool user
- Browser local storage
Connections 23
- Tool user → Tool dashboard: opens
README.md - Tool dashboard → Tool catalog: lists tools
src/app/page.tsx - Tool dashboard → Software shortcuts: lists shortcuts
src/app/page.tsx - Tool dashboard → Dashboard layout: renders in
src/app/page.tsx - Dashboard layout → Sidebar navigation: renders
src/components/layout/DashboardLayout.tsx - Sidebar navigation → Tool catalog: lists tools
src/components/layout/Sidebar.tsx - Sidebar navigation → Theme toggle: renders
src/components/layout/Sidebar.tsx - Tool user → Merger page: opens
- Merger page → Dashboard layout: renders in
src/app/tools/pdf-merger/page.tsx - Merger page → PDF merger UI: renders
src/app/tools/pdf-merger/page.tsx - PDF merger UI → PDF merge engine: merges PDFs
src/app/tools/pdf-merger/PdfMerger.tsx - Tool user → Reader page: opens
- Reader page → Dashboard layout: renders in
src/app/tools/pdf-reader/page.tsx - Reader page → PDF reader UI: renders
src/app/tools/pdf-reader/page.tsx - PDF reader UI → PDF viewer: renders
src/app/tools/pdf-reader/PdfReader.tsx - Tool user → Shortener page: opens
- Shortener page → Dashboard layout: renders in
src/app/tools/url-shortener/page.tsx - Shortener page → Shortener UI: renders
src/app/tools/url-shortener/page.tsx - Shortener UI → URL creation API: submits URL
- URL creation API → Short URL table: checks and inserts
src/app/api/urls/route.ts - Tool user → Short-code redirect: visits short code
- Short-code redirect → Short URL table: reads and counts
src/app/[code]/route.ts - Theme toggle → Browser local storage: saves preference
src/components/layout/ThemeToogle.tsx