WiSaw - "What I Saw Today"

October 14, 2025 · View on GitHub

Minimalistic social sharing • Incognito pics • Anonymous posting

🌟 Overview

WiSaw is a location-based, anonymous social sharing app that lets you capture and share moments without the complexity of traditional social media. No registration, no profiles, no followers - just pure, location-relevant content sharing.

✨ Key Features

🚫 No Registration Required - Open the app and start sharing immediately
📍 Location-Based Feed - See what's happening around you right now
🎭 Anonymous Sharing - Share without revealing your identity
🗑️ Community Moderation - Delete inappropriate content to improve quality for everyone
🤖 AI Image Recognition - Automatic content descriptions using AI
💬 Real-time Comments - Engage with posts through anonymous comments
🔗 Deep Linking - Share specific photos and friend invitations
📱 Cross-Platform - Available on iOS, Android, and Web

📱 Download

🌐 Web Version: wisaw.com

🛠️ Tech Stack

Frontend

React Native (0.79.4) - Cross-platform mobile development
Expo (53.0.12) - Development platform and build system
Expo Router (5.1.0) - File-based routing system
TypeScript - Type-safe development
Jotai (2.8.4) - State management

Backend Integration

Apollo Client (3.9.7) - GraphQL client with caching
GraphQL (16.8.1) - API query language
WebSocket Subscriptions - Real-time updates

UI/UX

React Native Elements - UI component library
React Navigation - Navigation system
Expo Image - Optimized image handling
React Native Reanimated - Smooth animations

Device Features

Camera & Photo Library - Image capture and storage
Location Services - GPS-based content filtering
Push Notifications - Real-time alerts
Deep Linking - Share content and friend invitations

🏗️ Architecture

Project Structure

WiSaw/
├── app/                    # Expo Router app directory
│   ├── (drawer)/          # Drawer navigation layout
│   │   ├── (tabs)/        # Bottom tabs navigation
│   │   │   ├── index.tsx  # Main feed screen
│   │   │   ├── chat.tsx   # Chat/messaging screen
│   │   │   └── photos/    # Photo-related screens
│   │   ├── friends.tsx    # Friends management
│   │   └── feedback.tsx   # User feedback
│   └── _layout.tsx        # Root layout
├── src/                   # Source code
│   ├── components/        # Reusable components
│   ├── screens/           # Screen components (legacy)
│   ├── utils/             # Utility functions
│   ├── hooks/             # Custom React hooks
│   └── state.js           # Global state management
├── assets/                # Images, icons, splash screens
├── docs/                  # Documentation and guides
└── public/                # Static web assets

Key Features Implementation

Expo Router with file-based routing
Drawer Navigation for main app sections
Tab Navigation for primary features
Modal Navigation for overlays and forms

🎨 UI/UX Enhancements

Status Bar Handling - Platform-specific status bar management
Safe Area Support - Proper handling of device safe areas
Responsive Design - Adapts to different screen sizes
Loading States - User feedback during operations

🔄 State Management

Jotai for lightweight state management
Apollo Client Cache for GraphQL data
Local Storage for offline data persistence

🔐 Privacy & Security

Anonymous Posting - No user identification required
Location Privacy - Approximate location sharing only
Content Moderation - Community-driven content filtering

🚀 Getting Started

Prerequisites

Node.js (18+)
npm or yarn
Expo CLI
iOS Simulator (for iOS development)
Android Studio/Emulator (for Android development)

Installation

Clone the repository

git clone https://github.com/echowaves/WiSaw.git
cd WiSaw

Install dependencies
```
npm install
```

Set up environment variables

# Create .env file with your API endpoints
API_URI=your_graphql_endpoint
REALTIME_API_URI=your_websocket_endpoint
API_KEY=your_api_key
PRIVATE_IMG_HOST=your_image_host

Start the development server
```
npm start
```

Development Scripts

# Start Expo development server
npm start

# Run on iOS simulator
npm run ios

# Run on Android emulator
npm run android

# Build for production
npm run build

# Deploy to production
npm run publish:prod

# Clear cache and reset
npm run clear
npm run reset:simulator