Skip to content

A mindful dating app for conscious souls seeking meaningful connections. Built with React Native/Expo, Firebase, and Stripe. Features spiritual compatibility matching, healing modalities, and authentic community building beyond superficial swiping.

Notifications You must be signed in to change notification settings

canberkvarli/fullcircle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

fullcircle™ • Meaningful Connections

fullcircle™ Logo

Where conscious souls unite. Connect with fellow seekers who practice meditation, yoga, energy healing, and embrace mindful living.

🌟 About

fullcircle™ is a mindful dating and connection app designed for individuals seeking meaningful relationships. Unlike mainstream dating apps, fullcircle™ focuses on compatibility, mindful matching, and authentic connections based on shared values and spiritual practices.

✨ Core Features

🔮 Mindful Matching

  • Spiritual Compatibility: Match based on meditation, yoga, energy healing, and spiritual practices
  • Healing Modalities: Connect through shared healing approaches (Reiki, acupuncture, etc.)
  • Conscious Community: Join circles of like-minded seekers on similar journeys

💫 Exclusive Features (fullcircle+)

  • Lotus System: Special likes that stand out to potential matches
  • Radiance: Boost your profile visibility
  • Enhanced Matching: Advanced compatibility metrics and filters
  • Priority Matching: Get seen by more potential connections

🧘‍♀️ Unique Onboarding

  • Spiritual Profile: Define your spiritual draws, practices, and healing modalities
  • Connection Intent: Choose between dating, friendship, or both
  • Personal Journey: Share your spiritual path and growth areas

🛠️ Tech Stack

  • Frontend: React Native with Expo Router
  • Backend: Firebase (Authentication, Firestore, Storage, Functions)
  • Authentication: Phone verification, Google SSO, Apple Sign-In
  • Payments: Stripe integration with subscription management
  • State Management: React Context API
  • Deployment: iOS and Android via EAS Build

🏗️ Project Structure

fullcircle/
├── app/                    # Expo Router app structure
│   ├── (tabs)/            # Main navigation tabs
│   │   ├── Connect.tsx    # Main matching/discovery screen
│   │   ├── KindredSpirits.tsx # Likes and matches
│   │   ├── SoulChats.tsx  # Chat interface
│   │   └── SacredSelf.tsx # User profile and journey
│   ├── onboarding/        # Multi-step onboarding flow
│   │   ├── LoginSignupScreen.tsx
│   │   ├── PhoneVerificationScreen.tsx
│   │   ├── SpiritualDrawsScreen.tsx
│   │   ├── SpiritualPracticesScreen.tsx
│   │   ├── HealingModalitiesScreen.tsx
│   │   └── [other onboarding screens]
│   ├── user/             # User settings and subscription
│   └── admin/            # Admin dashboard
├── components/           # Reusable UI components
├── context/             # React Context providers
├── services/            # Firebase and API services
├── functions/          # Firebase Cloud Functions
│   ├── stripe/         # Payment processing
│   ├── notifications.js # Push notifications
│   ├── weeklyLotus.js  # Weekly lotus assignment
│   └── selfieVerification.js
├── constants/          # App constants and mappings
└── assets/            # Images, fonts, icons

🔥 Firebase Integration

Authentication

  • Phone verification with SMS
  • Google Sign-In
  • Apple Sign-In
  • Custom authentication flow

Firestore Collections

  • users: User profiles, preferences, and spiritual data
  • matches: Like/dislike interactions and compatibility
  • chats: Real-time messaging between matches
  • subscriptions: Stripe subscription management

Cloud Functions

  • Stripe Integration: Subscription management, payments, webhooks
  • Weekly Lotus: Automated weekly lotus assignment
  • Notifications: Push notifications for matches, messages, lotus
  • Selfie Verification: Photo verification system
  • Admin Access: Admin dashboard functionality

🚀 Getting Started

Prerequisites

  • Node.js (v18+)
  • Yarn or npm
  • Expo CLI
  • Firebase project
  • iOS/Android development environment

Installation

  1. Clone the repository

    git clone https://github.com/canberkvarli/fullcircle.git
    cd fullcircle
  2. Install dependencies

    yarn install
  3. Environment Setup

    # Development environment
    npm run env:dev
    
    # Production environment
    npm run env:prod
  4. Start Development Server

    # Development with tunnel
    npm run dev:tunnel
    
    # Clear cache and start
    npm run dev:clear

Firebase Functions Setup

  1. Deploy Functions

    cd functions
    npm run deploy
  2. Verify Deployment

    firebase functions:list

Build & Deploy

# Development builds
npm run build:dev

# Production builds  
npm run build:prod

# Platform-specific builds
npm run ios:dev
npm run android:dev

📱 Key Screens

Main App Tabs

  • Connect: Discover and match with like-minded individuals
  • Kindred Spirits: View likes, matches, and mutual connections
  • Soul Chats: Real-time messaging with matches
  • Sacred Self: Personal profile, journey tracking, and settings

Onboarding Flow

  • Phone verification and authentication
  • Personal information (name, age, location)
  • Spiritual profile creation
  • Photo upload and bio
  • Connection preferences

💰 Subscription Model

fullcircle+ Features

  • Lotus System: Special likes that stand out
  • Radiance: Profile visibility boost
  • Enhanced Filters: Advanced matching criteria
  • Priority Matching: Increased visibility
  • Unlimited Likes: No daily limits

Payment Processing

  • Stripe integration for secure payments
  • Subscription management
  • Webhook handling for payment events
  • Cross-platform payment support

🔧 Development Scripts

# Environment management
npm run env:dev          # Switch to development
npm run env:prod         # Switch to production

# Development
npm run dev              # Start dev server
npm run dev:tunnel       # Start with tunnel
npm run dev:clear        # Clear cache and start

# Building
npm run build:dev        # Development build
npm run build:prod       # Production build

# Platform setup
npm run setup:ios:dev    # iOS development setup
npm run setup:android:dev # Android development setup

# Firebase Functions
npm run deploy:functions # Deploy cloud functions
npm run test:lotus       # Test weekly lotus function

🧪 Testing & Utilities

  • Seed Data: Generate test users for development
  • Reset Matchmaking: Clear matchmaking data for testing
  • Weekly Lotus Testing: Test automated lotus assignment
  • Admin Dashboard: User management and analytics

👥 Development Team

  • Canberk: Lead Software Engineer & Actor (Berkeley)

📄 Legal & Safety

  • Terms of Service: Users must be 18+, agree to community guidelines
  • Privacy Policy: Comprehensive data protection policies
  • Safety Guidelines: Recommendations for safe interactions
  • Selfie Verification: Photo verification for authenticity

🔮 Vision

fullcircle™ creates a space where conscious individuals can find meaningful connections beyond superficial swiping. By focusing on spiritual compatibility, mindful interactions, and authentic community, fullcircle™ facilitates deeper, more genuine relationships.


© 2025 fullcircle™ - Meaningful Connections

About

A mindful dating app for conscious souls seeking meaningful connections. Built with React Native/Expo, Firebase, and Stripe. Features spiritual compatibility matching, healing modalities, and authentic community building beyond superficial swiping.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published