Your personal jotter for documenting questions, discoveries, goals, and ideas

A modern, secure, and beautiful Progressive Web App for jotting down notes, tracking goals, and personal knowledge management. Built with React 19, Firebase, and WebAuthn biometric authentication.

Try Curiosity PWA live: https://curiosity-pwa.web.app

• 📝 Rich Text Editing - Create entries with markdown support and rich text editing
• 📅 Calendar View - Visualize your timeline with an interactive calendar
• 🎯 Goals & Tasks - Track personal goals and daily tasks with progress indicators
• 🔒 Secure Vault - Store sensitive information with PIN and biometric protection
• 🔔 Smart Reminders - Get notified for important dates (requires app to be open)
• 📊 Data Export - Export your data to PDF, JSON, or Markdown
• 🎁 On This Day - Revisit memories from past years
• 🔍 Search & Filter - Quickly find entries with powerful search

• 🎨 Animated Dashboard - Vibrant dashboard with Framer Motion animations
• 🌓 Dark Mode - System-aware theme switching
• 🎨 6 Accent Colors - Teal, Blue, Purple, Rose, Amber, Emerald
• 📝 4 Font Families - Inter, Lora, Merriweather, Roboto Mono
• 📱 Mobile-First - Optimized for mobile with hamburger navigation
• ✨ Live Preview - See theme changes in real-time during setup

• 🔐 Biometric Auth - WebAuthn support for fingerprint/face unlock
• 🔑 PIN Lock - Secure PIN-based app protection with configurable timeout
• � Local-First - IndexedDB storage for offline-first architecture
• ☁️ Optional Cloud Sync - Firebase sync when you need it
• � Secure Encryption - Client-side encryption for sensitive data

• 📲 Installable - Add to home screen on mobile and desktop
• ⚡ Offline Support - Full functionality without internet
• 🔄 Auto-Updates - Seamless updates via service worker
• 🚀 Fast Loading - Optimized with code splitting and caching

• Node.js 18+ and npm
• Firebase CLI (for deployment)
• Git

# Clone the repository
git clone https://github.com/ny-collins/curiosity-pwa.git
cd curiosity-pwa

# Install dependencies
npm install

# Create environment file
cp .env.example .env
# Edit .env with your Firebase config

# Start development server
npm run dev

The app will be available at http://localhost:5173

# Build for production
npm run build

# Preview production build
npm run preview

See the Deployment Guide for detailed instructions on deploying to Firebase, Vercel, or Netlify.

Comprehensive documentation is available in the docs/ folder:

• 📋 Quick Reference - Common commands and tasks
• 🛠️ Developer Setup - Development environment setup
• � Deployment Guide - Production deployment checklist
• ✅ Production Ready - Production readiness status

• 🏗️ Architecture - System design and data models
• 🔧 API Reference - Technical API documentation
• 🧪 Testing Guide - Testing strategies

• 📱 User Guide - Complete feature walkthrough
• 🤝 Contributing - Contribution guidelines
• 🔍 Troubleshooting - Common issues and solutions

• 📝 Changelog - Version history and release notes

• React 19.1.1 - Latest React with modern hooks
• Vite 7.1.7 - Lightning-fast build tool and dev server
• Tailwind CSS 3.4.4 - Utility-first CSS framework
• Framer Motion 12.23.24 - Beautiful animations and transitions
• Lucide React 0.546.0 - Modern icon library
• Dexie 4.0.8 - IndexedDB wrapper for offline storage
• React Calendar - Interactive calendar component
• React Markdown - Markdown rendering

• Firebase 12.4.0 - Backend-as-a-Service platform
  • Firestore - NoSQL database with real-time sync
  • Cloud Functions - Serverless backend
  • Firebase Auth - User authentication (Google OAuth)
  • Firebase Hosting - CDN-backed hosting
  • Cloud Storage - Secure file storage
• SimpleWebAuthn - WebAuthn biometric authentication
• bcrypt-ts - Secure password hashing

• Vite PWA Plugin - Service worker generation
• Workbox - Advanced caching strategies
• Code Splitting - Optimized bundle sizes
• Service Worker - Offline-first architecture

Curiosity embraces a mobile-first, local-first, privacy-focused approach:

• Beautiful & Vibrant - Animated dashboard with delightful interactions
• Mobile-First - Optimized for mobile with responsive design
• Local-First - Your data stays on your device by default
• Privacy-Focused - PIN lock and biometric authentication
• Customizable - Multiple themes, fonts, and colors
• Accessible - Keyboard navigation and screen reader support
• Fast - Optimized for performance and battery life

curiosity-pwa-vite/
├── src/
│   ├── components/         # React components
│   │   ├── Dashboard.jsx   # Animated dashboard with Framer Motion
│   │   ├── ModernEditor.jsx # Rich text editor
│   │   ├── SettingsPage.jsx # Settings and customization
│   │   ├── CalendarView.jsx # Calendar visualization
│   │   ├── PinLockScreen.jsx # PIN authentication
│   │   └── ...             # Other components
│   ├── contexts/
│   │   ├── AppContext.jsx  # Global app state
│   │   └── StateProvider.jsx # State management
│   ├── constants.js        # App constants and config
│   ├── firebaseConfig.js   # Firebase initialization
│   ├── db.js              # IndexedDB setup (Dexie)
│   └── utils.js           # Utility functions
├── public/
│   ├── icons/             # PWA icons
│   └── manifest.json      # PWA manifest
├── functions/             # Firebase Cloud Functions
├── docs/                  # Documentation
├── firebase.json          # Firebase configuration
├── firestore.rules        # Firestore security rules
├── vite.config.js         # Vite configuration
└── package.json           # Dependencies

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• SimpleWebAuthn - WebAuthn implementation
• Lucide - Beautiful icon library
• Framer Motion - Amazing animations
• Tailwind CSS - Utility-first CSS framework
• Firebase - Backend platform
• React - UI library
• Vite - Build tool

• 📧 Email: [email protected]
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📚 Documentation: docs/

Made with ❤️ by Collins • Version 1.0.1 • November 2025