|
11 | 11 | * **Web View:** A "Bento Grid" dashboard. High-density information, desktop-optimized. Hosted on GitHub Pages. |
12 | 12 | * **Android View:** A "Native-Style" app. Bottom navigation bar, thumb-friendly buttons, full-screen focus. Built as an APK. |
13 | 13 | * **Live Simulation:** The project includes a `viewMode` state (`web` | `android`). |
14 | | - * In `npm run dev`, a floating toggle allows switching views instantly to test the "Chameleon" shift. |
| 14 | + * In `npm run dev`, a floating toggle (bottom-right) allows switching views instantly to test the "Chameleon" shift. This toggle is protected by `import.meta.env.DEV` and is invisible in production. |
15 | 15 |
|
16 | 16 | ## 🚀 3. Final Products & Deployment |
17 | | -1. **Web Version:** Built via Vite and auto-pushed to the `gh-pages` branch on GitHub. |
| 17 | +1. **Web Version:** Built via Vite and auto-pushed to the `gh-pages` branch on GitHub via `.github/workflows/deploy.yml`. |
18 | 18 | 2. **Android APK:** Wrapped via Capacitor. The APK is compiled using GitHub Actions (`create-android.yml`) so the user can download it from GitHub "Releases." |
19 | 19 |
|
20 | 20 | ## 📈 4. Evolution Log (Milestones Only) |
|
24 | 24 | - **[2026-01-29]:** Defined "Privacy Protocol" and "Chameleon Mode" in GEMINI.md. |
25 | 25 | - **[2026-01-29]:** Implemented Chameleon Mode (Web/Android views) and Dark/Light theme engine with persistence. |
26 | 26 | - **[2026-01-29]:** Revamped UI with Rose (#F43F5E) accent and custom PaperKnife airplane logo. |
| 27 | +- **[2026-01-29]:** Optimized performance with Code Splitting (React.lazy) and integrated Plus Jakarta Sans typography. |
| 28 | +- **[2026-01-29]:** Automated GitHub Pages deployment and sanitized repository tracking (removed node_modules/dist). |
| 29 | +- **[2026-01-30]:** Migrated to React Router for SEO and unique URLs (e.g., /merge, /about). |
| 30 | +- **[2026-01-30]:** Implemented functional Merge PDF tool with local processing via `pdf-lib`. |
| 31 | +- **[2026-01-30]:** Added advanced Merge features: PDF thumbnails (pdfjs-dist) and drag-and-drop reordering (@dnd-kit). |
| 32 | +- **[2026-01-30]:** Refined UI/UX: Minimalist branding, mobile optimization, and seamless theme transitions. |
| 33 | + |
| 34 | +## 🏗️ 5. Architectural Notes |
| 35 | +* **Routing:** Uses `react-router-dom` with a `/PaperKnife/` basename for GitHub Pages compatibility. |
| 36 | +* **PDF Core:** `pdf-lib` handles all manipulation (creation, copying pages, merging). |
| 37 | +* **PDF Rendering:** `pdfjs-dist` (v5+) used for thumbnail generation via local worker URL. |
| 38 | +* **UI Components:** |
| 39 | + * `Logo.tsx`: Centralized brand logo to prevent circular dependencies. |
| 40 | + * `WebView.tsx`: Main Bento Dashboard. |
| 41 | + * `AndroidView.tsx`: Mobile-first dashboard with bottom nav. |
| 42 | + * `tools/`: Directory for individual tool implementations. |
| 43 | +* **State Management:** Local React state + localStorage for persistence (Theme). |
| 44 | +* **Transitions:** GPU-accelerated CSS transforms for page slides and theme fading. |
0 commit comments