Perceptive App is a reflective journaling and belief analysis app built around one core idea:

🧠 Perceptive App

Challenge Your Beliefs

“Challenge your beliefs. Evolve your understanding.”

Perceptive is a personal belief-tracking and critical-thinking web app that helps you examine, challenge, and evolve your beliefs over time. Log what you believe, document your evidence and assumptions, receive AI-powered analysis, and track how your beliefs change all in a sleek dark-mode interface.

---

📸 Preview

┌─────────────────────────────────────────────┐
│  Perceptive        [User Name]  [Sign Out]  │
│  Challenge your beliefs                     │
├─────────────────────────────────────────────┤
│  💡 Daily Challenge                         │
│  "What is one belief you've never           │
│   questioned?"  [Self-Reflection]           │
├─────────────────────────────────────────────┤
│  + New Belief                               │
│  Statement | Evidence | Assumptions |       │
│  Falsifiability                             │
├─────────────────────────────────────────────┤
│  Your Beliefs                               │
│  ── January 2025 ──────────────────         │
│  │ "Hard work always leads to success"      │
│  │ [active] • Jan 5, 2025                   │
│  │ [Show Details] [Status ▾] [🗑]           │
└─────────────────────────────────────────────┘

---

✨ Features

🔐 Authentication

Sign in with Email/Password or Google OAuth (mock simulation). Your session and all belief data persist in localStorage between visits.

💡 Daily Challenge

Every day, a new philosophical prompt is surfaced — deterministically seeded from the date — to spark critical self-reflection. Categories include Self-Reflection, Intellectual Honesty, Falsifiability, Source Analysis, and more.

📝 Belief Logging

Submit a new belief with four structured fields:

• Statement: What do you believe to be true?

• Evidence: What supports this belief?

• Assumptions: What are you taking for granted?

• Falsifiability: What evidence would prove this wrong?

📊 Belief Status Tracking

Each belief has a lifecycle status you can update at any time:

Status Meaning

🟢 Active You currently hold this belief

🟡 Modified You’ve refined or partially changed it

🔴 Replaced This belief has been superseded by a new one

🤖 AI Analysis

Trigger on-demand analysis on any belief. The engine detects linguistic patterns absolutes (always, never), generalizations (everyone, nobody), obligations (should, must), and comparatives (better, worse) and returns:

• Hidden Assumptions: Implicit claims embedded in your belief

• Counter-Arguments: Challenges to probe the belief’s validity

• Confidence Score : A simulated certainty rating

🗓️ Timeline View

All beliefs are grouped chronologically by month, displayed in a vertical timeline. Empty states are handled gracefully with a prompt to add your first belief.

---

🗂️ Project Structure

src/
├── App.tsx                        # Root — auth gate, layout, main state
├── types/
│   ├── belief.ts                  # Belief, BeliefStatus, AIAnalysis interfaces
│   ├── auth.ts                    # User interface
│   └── index.ts                   # PerceptionEntry, Reflection interfaces
├── hooks/
│   ├── useAuth.ts                 # Auth state, signIn/signOut, localStorage sync
│   ├── useBeliefs.ts              # CRUD for beliefs, localStorage persistence
│   └── usePerceptions.ts          # Perception entry management
├── components/
│   ├── AuthScreen.tsx             # Login page (Email + Google OAuth)
│   ├── DailyChallenge.tsx         # Date-seeded daily philosophical prompt
│   ├── BeliefForm.tsx             # Form to add a new belief (4 fields)
│   ├── BeliefCard.tsx             # Individual belief card with expand/collapse
│   ├── AIAnalysis.tsx             # AI insight trigger & results display
│   ├── Timeline.tsx               # Month-grouped belief timeline
│   ├── EntryCard.tsx              # Perception entry card
│   ├── EntryList.tsx              # List of perception entries
│   ├── InsightBadge.tsx           # Badge component for insights
│   └── JournalForm.tsx            # Journal/reflection form
└── utils/
    ├── mockAI.ts                  # AI analysis engine (pattern-based NLP)
    ├── challenges.ts              # 7 philosophical challenge prompts + daily selector
    ├── storage.ts                 # localStorage read/write helpers
    └── localStorage.ts            # Additional storage utilities

---

🚀 Getting Started

Prerequisites

• Node.js ≥ 18

• npm or yarn

Installation

# Clone the repository
git clone https://github.com/your-username/perceptive.git
cd perceptive

# Install dependencies
npm install

# Start the development server
npm run dev

Open

http://localhost:5173

in your browser.

Build for Production

npm run build
npm run preview

---

🛠️ Tech Stack

Technology Purpose React 18 UI framework with hooks-based state management TypeScript Fully typed data models and component props Tailwind CSS Dark-mode utility-first styling (slate palette) shadcn/ui Card, Button, Input, Select, Label components Lucide React Icons (Brain, Lightbulb, LogOut, Trash2, etc.) date-fns Date formatting for timeline grouping localStorage Client-side persistence for user & belief data Vite Fast development and production build tool

---

Key Implementation Details

Auth Flow

Authentication is fully mocked on the client. useAuth loads a saved user from localStorage on mount. Sign-in creates a new User object with crypto.randomUUID() and saves it. Google OAuth is simulated with a 1-second delay.

This is a frontend-only prototype. For production, replace the mock auth in useAuth.ts with a real provider (Firebase Auth, Supabase, Auth0, etc.).

Daily Challenge Algorithm

The daily prompt is seeded deterministically from the current date string — no backend required:

const index = today.split("").reduce((acc, char) => acc + char.charCodeAt(0), 0)
               % PHILOSOPHICAL_CHALLENGES.length;

This ensures every user sees the same challenge on the same day.

AI Analysis Engine

The analyzeBelief() function in mockAI.ts performs keyword-based linguistic analysis to surface hidden assumptions and counter-arguments. It checks for:

• Absolutes — always, never

• Universal claims — everyone, nobody, all

• Imperatives — should, must, ought

• Comparatives — better, worse

• Certainty markers — know, certain

💡 To upgrade to real AI analysis, replace analyzeBelief() with an API call to OpenAI, Claude, or another LLM provider.

Data Persistence

All data is stored in localStorage under two keys:

• perceptive_beliefs — array of Belief objects

• perceptive_user — current authenticated User

---

💬 Philosophy

“The first principle is that you must not fool yourself and you are the easiest person to fool.” : Richard Feynman

Perceptive is built on the idea that intellectual honesty requires actively stress-testing what we believe, not just defending it.