feat: Bookmark Manager PWA — full architectural refactor (v1.0.0)#17
Merged
davidangarita1 merged 4 commits intodevelopfrom Mar 10, 2026
Merged
feat: Bookmark Manager PWA — full architectural refactor (v1.0.0)#17davidangarita1 merged 4 commits intodevelopfrom
davidangarita1 merged 4 commits intodevelopfrom
Conversation
- Replace Bootstrap/SCSS with TailwindCSS - Add Zustand for state management (replacing Context API) - Add Fuse.js for fuzzy search - Add vite-plugin-pwa for PWA support - Refactor resources.json to new schema (id, title, url, description, category, tags, createdAt) - Remove pendings.json, unused deps (axios, bootstrap, formik, dotenv) - Create service layer: storageService, searchService, resourceService - Create Zustand store with filters, favorites, statuses, search - Create custom hooks: useResources, useFavorites, useStatuses, useSearch - Create UI components: ResourceCard, SearchBar, Sidebar, Topbar, TagList, CategoryList - Create pages: Dashboard with grid layout, NotFound - Implement localStorage persistence for favorites and statuses - Implement status cycling: pending -> consumed -> reference -> none - Add 49 unit tests (services, hooks, components) - Configure PWA manifest and service worker - Update path aliases and tsconfig
…k checker - fix(search): rewrite useResources to subscribe to all store slices reactively searchQuery/searchResults/activeFilter/activeCategory/favorites/statuses are now direct Zustand subscriptions so any change triggers a re-render - fix(dark-mode): add @custom-variant dark to index.css for Tailwind v4 class-based dark mode Tailwind v4 defaults to prefers-color-scheme; class variant requires '@custom-variant dark (&:is(.dark, .dark *))' in CSS Topbar refactored: applyDarkMode() syncs classList+localStorage atomically, no more stale useEffect, reads system preference as fallback - refactor(tests): move all tests to src/__tests__ mirroring src structure src/__tests__/services/storageService.test.ts src/__tests__/services/searchService.test.ts src/__tests__/hooks/useFavorites.test.ts src/__tests__/hooks/useStatuses.test.ts src/__tests__/components/ResourceCard.test.tsx src/__tests__/components/SearchBar.test.tsx All 49 tests pass from new location - feat(script): add check-links.sh to verify URL availability Parallelizes curl checks (default 10 workers, configurable) Reports HTTP status codes for broken/inaccessible links Saves timestamped TXT report when broken links are found Usage: ./check-links.sh [--timeout N] [--parallel N]
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Complete refactor of the application from a simple resource viewer into a full Bookmark Manager PWA with offline support, Zustand state management, fuzzy search, and a clean modular architecture.
What Changed
Stack
Architecture
New modular structure following SOLID, Clean Code, and Separation of Concerns:
Features
localStorage@custom-variant dark, persisted inlocalStorageData
resources.jsonmigrated to clean schema:id, title, url, description, category, tags, createdAtpendings.jsonremoved — dynamic state lives inlocalStorageBug Fixes
useResourcesnow subscribes to all Zustand slices so any state change triggers re-renderapplyDarkMode()syncsclassList+localStorageatomically (no staleuseEffect)Tests
src/__tests__/mirroringsrc/structureTooling
check-links.shscript — parallelized URL checker with configurable workers and timeout, outputs broken-link reportTesting
Release
Tagged as v1.0.0