Enterprise-Grade Intentions & Focus Engine
Mindful task orchestration with kinetic motion architecture, authoritative server validation, and local-first data resilience.
-003B57?style=flat-square&logo=sqlite&logoColor=white){kind=icon}
Never Forget is a high-reliability, distraction-free productivity engine engineered for mindful task capture, proactive time management, and cognitive relief. Architected around a Local-First / Server-Authoritative paradigm, Never Forget combines a fluid aesthetic canvas with strict schema guarantees, zero external telemetry leaks, and cross-platform native readiness across Web, PWA, and Android.
NEVER FORGET ARCHITECTURE
┌─────────────────────────────────────────────────────────────────┐
│ Client Experience Layer │
│ [ Celestial Canvas ] [ Clockwork Astrolabe ] [ Constellations ]│
│ [ Notebook Pencil Canvas with Typewriter & Screensaver Drift ] │
└───────────────────────────────┬─────────────────────────────────┘
│
┌───────────────────────┴───────────────────────┐
▼ ▼
┌───────────────────────────────┐ ┌─────────────────────────────┐
│ Static PWA / Android Native│ │ Enterprise Nuxt Server │
│ - Capacitor Preferences │ │ - Nitro HTTP Engine │
│ - Scheduled Local Alarms │ │ - Authoritative Zod Guard │
│ - Offline Autonomous Store │ │ - SQLite Engine (WAL mode) │
└───────────────────────────────┘ └─────────────────────────────┘
- Modular Domain Partitioning: Divide-and-rule architecture isolating Background Canvases, Goal Management, Modal Overlays, and Kinematic Gesture Navigation into self-contained sub-modules.
- Kinematic Motion System: Organic mathematical physics engine featuring fluid mouse parallax tracking, live typewriter equation drawing, and screensaver drift with guaranteed non-overlapping sector shuffling.
- Authoritative Validation: All mutations pass through strict Zod schemas enforced server-side before persisting into transactional SQLite storage.
- Privacy & Data Sovereign: Zero analytics tracking, no external ad SDKs, and local-first data isolation.
| Feature | Specification | User Benefit |
|---|---|---|
| Instant Intention Capture | Curated psychological triggers & custom text | Seamlessly offload mental cache in under 2 seconds. |
| Proactive Scheduling | +10 Min, Tonight at 8:00 PM, Custom Datetime | Contextual reminder workflows with one-touch triggers. |
| Artistic Multi-Canvas FX | Celestial Sky, Clockwork Orbit, Constellation, Notebook | Focus-enhancing ambient aesthetics with zero cognitive fatigue. |
| Multi-Theme Engine | 4 Light (Parchment, Terracotta, Sage, Amber) + 4 Dark (Indigo, Obsidian, Emerald, Plum) | Engineered contrast and typography optimized for day/night focus. |
| Fail-Safe Undo & Edit | In-place undo toast & instant inline modification | Eliminates accidental completions without disruptive confirm modals. |
| Cross-Platform Delivery | Browser Web, Progressive Web App, Native Android (APK) | Universal availability across mobile and desktop workstations. |
- Node.js:
v24.0.0or higher - Package Manager:
npm(v10+)
Clone the repository and install project dependencies:
git clone https://github.com/dr-week/neverforget.git
cd neverforget
npm installLaunch the development instance with hot module replacement:
npm run devNavigate to http://127.0.0.1:3000. The backend auto-initializes the transactional database at .data/neverforget.sqlite upon boot.
To compile and produce optimized client/server bundles:
# Typecheck TypeScript codebase
npm run typecheck
# Run test suite
npm test
# Generate production Nitro server
npm run build
# Preview production build locally
npm run preview| Variable | Default Value | Description |
|---|---|---|
DATABASE_PATH |
.data/neverforget.sqlite |
Filepath for the SQLite relational store. |
NEVERFORGET_MOBILE |
0 |
Disables SSR and toggles local Preferences adapter for static builds. |
PORT |
3000 |
HTTP port for the Nitro application server. |
TEST_URL |
http://127.0.0.1:3100 |
Endpoint target for integration and smoke test runs. |
Generate a standalone static application bundle in .output/public:
npm run web:staticSynchronize native assets and build via Capacitor:
# Sync web artifacts with native Android wrapper
npm run android:sync
# Compile debug Android APK
npm run android:apkOutput APK will be located under android/app/build/outputs/apk/debug/app-debug.apk.
NEVERFORGET/
├── app/
│ ├── components/
│ │ ├── backgrounds/ # Kinematic canvas layers (Celestial, Clockwork, Notebook)
│ │ ├── controls/ # Floating action bar & gesture controllers
│ │ ├── goals/ # Form, card list, header greetings, & edit modals
│ │ └── overlays/ # Settings drawers, journal modals, calming banner
│ ├── composables/ # Business logic (useIntentions, useThemeSettings, useMotion)
│ └── app.vue # Lean root application orchestrator
├── server/
│ ├── api/ # Nitro REST route handlers (/api/goals, /api/insights)
│ ├── middleware/ # CSRF origin security verification
│ └── utils/ # Database initialization & Zod schema validation
├── shared/ # Cross-environment types, contracts, & state machines
├── tests/ # Unit test suites and smoke integration checks
└── docs/ # Technical specifications and maintenance guides
For deep technical dives, refer to our comprehensive documentation library:
- Requirements & Specifications
- System Architecture & Persistence
- Codebase Structure Guide
- Modularity & Refactoring Plan
- Kinematic Motion Architecture
- Android Deployment & Local Alarms
- Design Research & Astrolabe Systems
Never Forget enforces rigorous automated verification standards across all code changes:
npm run typecheck # Strict TypeScript contract validation
npm test # Core logic & state transition test runner
npm run build # Production bundle synthesis & tree-shaking verificationThis project is distributed under the MIT License. See LICENSE for details.
Crafted with care and precision by the Never Forget Engineering Team.