Where conscious souls unite. Connect with fellow seekers who practice meditation, yoga, energy healing, and embrace mindful living.
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.
- 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
- 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
- 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
- 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
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
- Phone verification with SMS
- Google Sign-In
- Apple Sign-In
- Custom authentication flow
- users: User profiles, preferences, and spiritual data
- matches: Like/dislike interactions and compatibility
- chats: Real-time messaging between matches
- subscriptions: Stripe subscription management
- 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
- Node.js (v18+)
- Yarn or npm
- Expo CLI
- Firebase project
- iOS/Android development environment
-
Clone the repository
git clone https://github.com/canberkvarli/fullcircle.git cd fullcircle -
Install dependencies
yarn install
-
Environment Setup
# Development environment npm run env:dev # Production environment npm run env:prod
-
Start Development Server
# Development with tunnel npm run dev:tunnel # Clear cache and start npm run dev:clear
-
Deploy Functions
cd functions npm run deploy -
Verify Deployment
firebase functions:list
# Development builds
npm run build:dev
# Production builds
npm run build:prod
# Platform-specific builds
npm run ios:dev
npm run android:dev- 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
- Phone verification and authentication
- Personal information (name, age, location)
- Spiritual profile creation
- Photo upload and bio
- Connection preferences
- 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
- Stripe integration for secure payments
- Subscription management
- Webhook handling for payment events
- Cross-platform payment support
# 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- 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
- Canberk: Lead Software Engineer & Actor (Berkeley)
- 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
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
