Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Mosss-OS/vivid

Repository files navigation

Vivid - AI-Powered Second Brain Mobile App

React Native Expo TypeScript AI Gemini Groq Privy SQLite Drizzle ORM Zustand Tailwind Moti RAG Offline First Mobile App Knowledge Management

Vivid is a beautiful, fast, and intelligent AI-powered Second Brain mobile app. Users capture thoughts, notes, voice memos, images, PDFs, and links β€” the AI automatically organizes everything, finds connections, and lets users chat naturally with their entire personal knowledge base.

πŸ“Š Development Phase: Backend Integration & Local Database (Phase 3 of 4)

We have successfully implemented all core UI screens and basic functionality. We have now integrated backend services (Supabase) and state management (Zustand) with local database persistence (Expo SQLite + Drizzle ORM) for offline-first capabilities.

Phase Progress:

  • Phase 1: Project Setup & Core Navigation
  • Phase 2: MVP Foundation Complete
  • Phase 3: Backend Integration & AI Enhancement (Local DB Complete, AI Chat Integration Complete, Auth Complete, Syncing Complete)
  • Phase 4: Polish, Advanced Features & Deployment (Onboarding Complete, Dark Mode Complete, Settings Complete, Task Management Complete, Graph View Complete, Production Ready)

πŸš€ Current Implementation Status

βœ… Core Features Implemented

1. Project Foundation

  • React Native + Expo (latest version) with TypeScript
  • Expo Router for file-based navigation
  • Tab-based navigation (Home, Chat, Library, Settings)
  • Privy authentication integration (configured with actual credentials)
  • Authentication flow implemented (Email, Google, Apple login)
  • Onboarding flow with animations βœ…
  • Dark mode support with theme provider βœ…
  • Settings screen with theme toggle, sync, and more βœ…

2. Home Screen

  • Knowledge feed showing recent captures
  • AI Daily Insight card with generated insights
  • Search bar with basic functionality
  • Floating Action Button with capture options:
    • Quick Text Note (functional with AI tagging)
    • Voice Memo (functional)
    • Photo/Image Capture (functional)
    • PDF/Document Upload (functional)
    • Link/Article Save (functional)
    • Task Reminders βœ… (mark as task, set reminder date)

3. Capture Screens (All Functional)

  • Text Note: Title and content input with AI-powered tagging and categorization
  • Voice Memo: Recording with visual timer and audio capture
  • Image Capture: Camera and gallery picker with preview
  • Document Capture: File picker with type detection
  • Link/Article: URL input with preview fetching simulation

4. AI Chat Screen βœ… (Now with Real AI Integration)

  • Dedicated chat interface with message history
  • Voice input capability (microphone button)
  • Real AI integration with Groq (fallback to Gemini)
  • RAG (Retrieval-Augmented Generation) using your knowledge base
  • Citations and references to specific notes in responses
  • Suggested follow-up questions
  • Real-time typing indicators
  • Loading states and error handling

5. Graph/Connections View βœ…

  • Visual network of knowledge connections
  • Interactive nodes with emoji indicators
  • Zoom in/out controls
  • Node selection shows details
  • Connections based on shared tags and content similarity

5. Library Screen

  • Organized views by type: All, Ideas, Tasks, Insights, Projects, People, References
  • Favorite/bookmark functionality
  • Item previews with type indicators and badges
  • Stats dashboard showing totals and favorites

6. Graph/Connections View βœ…

  • Visual network of knowledge connections
  • Interactive nodes with emoji indicators
  • Zoom in/out controls
  • Node selection shows details
  • Connections based on shared tags and content similarity

6. Knowledge Item Detail View

  • Full-screen view of captured items
  • Action buttons (Share, Duplicate, Delete)
  • Metadata display (type, date, tags)

7. UI/UX Implementation

  • Clean, minimalist design with soft dark/light mode readiness
  • Smooth animations using Moti
  • Beautiful typography and spacing
  • Platform-appropriate styling (iOS/Android)
  • Glassmorphism effects and subtle depth
  • Micro-interactions and feedback
  • Responsive layouts

πŸ› οΈ Tech Stack Implemented

  • Framework: React Native + Expo (latest version)
  • Authentication: Privy (configured with actual app ID and secret)
  • UI: NativeWind (Tailwind) + Moti for animations
  • Navigation: Expo Router (file-based)
  • State Management: Zustand with persistence (implemented)
  • Local Database: Expo SQLite + Drizzle ORM (client configured, schema defined, basic operations implemented)
  • Backend: Supabase configured (client and schema ready, integration in progress)
  • AI Integration: Groq and Gemini clients configured with fallback logic
  • Media: Expo AV (audio), Expo ImagePicker, DocumentPicker
  • Icons: Lucide React Native

πŸ“± Project Structure

πŸ–ΌοΈ App Icon and Splash Screen

πŸ“± Project Structure

vivid/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ _layout.tsx           # Root layout with PrivyProvider
β”‚   β”œβ”€β”€ (tabs)/               # Tab-based navigation
β”‚   β”‚   β”œβ”€β”€ _layout.tsx       # Tabs layout
β”‚   β”‚   β”œβ”€β”€ index.tsx         # Home screen
β”‚   β”‚   β”œβ”€β”€ chat/             # Chat screen
β”‚   β”‚   β”‚   └── index.tsx
β”‚   β”‚   └── library/          # Library screen
β”‚   β”‚       └── index.tsx
β”‚   β”œβ”€β”€ capture/              # Capture screens
β”‚   β”‚   β”œβ”€β”€ text/             # Text note capture
β”‚   β”‚   β”‚   └── index.tsx
β”‚   β”‚   β”œβ”€β”€ voice/            # Voice memo capture
β”‚   β”‚   β”‚   └── index.tsx
β”‚   β”‚   β”œβ”€β”€ image/            # Image capture
β”‚   β”‚   β”‚   └── index.tsx
β”‚   β”‚   β”œβ”€β”€ document/         # Document capture
β”‚   β”‚   β”‚   └── index.tsx
β”‚   β”‚   └── link/             # Link capture
β”‚   β”‚       └── index.tsx
β”‚   β”œβ”€β”€ knowledge/            # Knowledge item detail
β”‚   β”‚   └── [id].tsx
β”‚   β”œβ”€β”€ components/           # Shared components
β”‚   β”‚   β”œβ”€β”€ FloatingActionButton.tsx
β”‚   β”‚   β”œβ”€β”€ KnowledgeCard.tsx
β”‚   β”‚   β”œβ”€β”€ AIDailyInsightCard.tsx
β”‚   β”‚   └── SearchBar.tsx
β”‚   └── types/                # TypeScript types
β”‚       └── knowledge.ts
β”œβ”€β”€ components/               # Additional components
β”œβ”€β”€ assets/                   # Images, icons, etc.
β”œβ”€β”€ README.md
β”œβ”€β”€ package.json
β”œβ”€β”€ TODO.md
└── tsconfig.json

πŸ”§ Setup Instructions

  1. Install dependencies:

    npm install
  2. Configure environment variables:

    • Create .env file with:
      EXPO_PUBLIC_PRIVY_APP_ID=your_privy_app_id
      EXPO_PUBLIC_SUPABASE_URL=your_supabase_url
      EXPO_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
      EXPO_PUBLIC_GROQ_API_KEY=your_groq_api_key
      
  3. Start the development server:

    npx expo start

🎯 Next Steps (High Priority)

See TODO.md for complete roadmap, but immediate priorities include:

  1. Backend Integration

    • Set up Supabase for data persistence
    • Implement offline-first sync with Expo SQLite + Drizzle ORM
    • Replace useState with Zustand/TanStack Query for state management
  2. AI Features

    • Integrate Groq API for smart tagging during capture
    • Implement RAG (Retrieval-Augmented Generation) for chat
    • Add structured outputs for consistent AI responses
  3. Persistence Layer

    • Implement Drizzle ORM schemas for knowledge items
    • Create CRUD operations for all capture types
    • Add synchronization with Supabase when online
  4. Enhanced AI Chat

    • Connect chat to actual AI API (Groq/Gemini/OpenAI)
    • Implement proper context management
    • Add citation/link referencing in responses
  5. Advanced Features

    • Task management with reminders (Expo Notifications)
    • Habit/progress tracking
    • Graph/connections view
    • Daily AI-powered notifications
    • Export functionality

πŸ“± Screenshots & Demo

Demo Video Script

See DEMO_SCRIPT.md for the complete 2-3 minute demo video script.

App Store Assets

  • App Icon: assets/icon.png (Vivid logo with gradient)
  • Splash Screen: assets/splash-icon.png
  • Screenshots: (To be taken during testing)

Video Demo Structure (180 Seconds)

  1. Hook (0:00-0:20): "Your notes, but smarter"
  2. Capture (0:20-0:50): Text, voice, photo, document, link
  3. AI Chat (0:50-1:30): THE KILLER FEATURE - Ask Vivid anything
  4. Graph View (1:30-1:50): Visual connections
  5. Advanced (1:50-2:10): Task reminders, dark mode
  6. Closing (2:10-3:00): Call to action

Record using: Actual phone + screen recording for authenticity!

🀝 Contributing

This is a hackathon project. Feel free to fork and experiment!

πŸ“„ License

MIT

About

Vivid - AI-Powered Second Brain Mobile App

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors