Skip to main content
NearYou will provide a rich set of exploration features designed to make discovering your city fun, engaging, and rewarding. This document outlines the planned exploration experience.
Most exploration features are currently in the planning phase. The current app provides the foundation with navigation structure, themed UI components, and cross-platform support.

​
Current Implementation

What’s working now:

Tab Navigation

File-based routing with Home and Explore tabs using Expo Router

Themed UI

Light and dark mode support with themed components

Cross-Platform

Runs on iOS, Android, and Web with consistent experience

Smooth Animations

React Native Reanimated for 60fps animations

​
Planned Core Features

The following features are planned for future development:

Real-Time Discovery

Discover new places as you move through your city in real-time

Personalized Suggestions

Get place recommendations based on your interests and exploration history

Exploration Map

Visualize your journey and see what you’ve discovered

Check-In System

Mark places as visited and track your exploration progress

​
Planned Navigation & Interface

NearYou’s tab-based navigation is ready for the following planned features:

​
Home Tab (Planned)

Your exploration dashboard will feature:
  • Nearby Places: Discover locations close to your current position
  • Quick Stats: See your points, level, and recent achievements at a glance
  • Daily Suggestions: Get personalized place recommendations
  • Active Challenges: View and track your current exploration goals
Current status: Basic welcome screen with example content from Expo Router template

​
Explore Tab (Planned)

Planned deep exploration features:
  • Interactive Map: Browse all discovered and undiscovered places
  • Category Filters: Find specific types of places
  • Distance Controls: Adjust your exploration radius
  • Search Function: Look for specific places by name or type
Current status: Template explore screen with collapsible information sections
The app uses file-based routing with Expo Router, providing smooth navigation and deep linking support across iOS, Android, and web platforms. This foundation is ready for implementing the planned exploration features.

​
Planned Check-In Experience

Users will be able to check in at places:
1

Arrive at Location

Navigate to a discovered place using your preferred map app.
2

Open Check-In

Tap the check-in button when you’re within range of the location.
3

Verify Location

The app will verify your GPS coordinates to confirm you’re at the place.
Location verification happens locally on your device for privacy.
4

Earn Points

Receive points and see any unlocked achievements immediately after check-in.

​
Current Technical Features

These features are already implemented:

​
Theming & Customization

From src/constants/theme.ts: 
export const Colors = {
  light: {
    text: '#11181C',
    background: '#fff',
    tint: '#0a7ea4',
    icon: '#687076',
    tabIconDefault: '#687076',
    tabIconSelected: '#0a7ea4',
  },
  dark: {
    text: '#ECEDEE',
    background: '#151718',
    tint: '#fff',
    icon: '#9BA1A6',
    tabIconDefault: '#9BA1A6',
    tabIconSelected: '#fff',
  },
};
The app automatically switches between light and dark themes based on system preferences.

​
Platform Support

Current cross-platform support:
PlatformStatusFeatures
iOS✅ SupportedNative SF Symbols, haptic feedback, smooth animations
Android✅ SupportedMaterial Icons, edge-to-edge UI, adaptive icons
Web✅ SupportedStatic export, responsive design, PWA-ready

​
Smooth Animations

Using React Native Reanimated 4.1: 
import Animated from 'react-native-reanimated';

// Example from HelloWave component
<Animated.Text
  style={{
    fontSize: 28,
    animationName: {
      '50%': { transform: [{ rotate: '25deg' }] },
    },
    animationIterationCount: 4,
    animationDuration: '300ms',
  }}>
  👋
</Animated.Text>
All animations run on the native thread for 60fps performance.

​
Planned Privacy & Data

When location features are implemented:
  • Location Privacy: All location processing happens on-device
  • Data Minimization: Only essential data collected
  • User Control: Granular permissions for location access
  • Offline Support: Core features work without internet connection
  • No Tracking: Location not tracked when app is closed

​
Upcoming Roadmap

According to the README’s “Next Features” section:
  • 🗺️ Advanced Filters: Filter places by category and type
  • 🏆 Achievement System: Expanded badges and milestone tracking
  • 💬 Reviews & Ratings: User-generated content for places
  • 🌐 Multi-Language: Support for Spanish and English (and more)

​
Getting Involved

This is an open-source project! Help implement exploration features:
  1. Review the Development Guide
  2. Check GitHub Issues
  3. See the Contributing Guide if available

View API Reference

Explore the components and hooks that power NearYou

Development Guide

Learn how to customize and extend NearYou’s features

Build docs developers (and LLMs) love

Get started for freeTalk to us