Skip to content

ishaaqdev/OnlyFriends

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Only Friends

A minimalist social accountability platform that turns group habits into shared progress. Built from real-world experience, backed by behavioral science.

πŸ† 2nd Place β€” ZeroOne Hackathon 2026

View Live Preview β†’


The Story

Before any code was written, there was a WhatsApp group. Five friends made a simple pact: share what you did today. Exercise logs with sweaty selfies. Book chapter summaries. Coding streaks. Every update had proof attached.

No algorithm, no suggested posts, no ads. Just five people holding each other accountable. And it worked for over a year. Some of us read 20+ books. Others hit fitness goals we'd been putting off for years.

The group became a ritual. Missing an update felt wrong. Seeing your friends hit their goals made you want to hit yours. That emotional loop β€” part competition, part community β€” is what we bottled into Only Friends.


Features

  • Private Communities β€” Create focused spaces for specific goals (Fitness, Reading, Coding, Morning Routines).
  • Shared Task Lists β€” Every member sees the same daily/weekly tasks. One group, one mission.
  • Duolingo-style Streaks β€” Maintain your daily streak. Break it, and you start over.
  • Point System & Leaderboards β€” Earn points for every task you complete. Compete in real-time rankings.
  • Progress Rings β€” Visual completion tracking for each community.
  • Achievement Badges β€” Unlock milestones like "Early Bird", "Streak Master", and "Century Club".
  • Notifications β€” Get notified when friends complete tasks, join communities, or overtake you on the leaderboard.
  • Minimal Dark UI β€” Distraction-free interface with premium aesthetics. No clutter.

Why It Works β€” The Psychology

This isn't just another habit tracker. Only Friends is grounded in real behavioral science research.

The Accountability Effect

Approach Success Rate
Goal set alone (willpower only) ~10%
Goal committed to someone ~65%
Goal with specific accountability check-ins ~95%

Source: American Society of Training & Development

The Mechanisms

  • Social Proof β€” When you see your friends completing tasks, it triggers motivation. Each completed task is a nudge. (Robert Cialdini, Influence)
  • Loss Aversion β€” Breaking a 30-day streak hurts more than skipping a single workout. Duolingo proved this at scale β€” streak mechanics drive 3Γ— more daily engagement.
  • Variable Rewards β€” Points, badges, and leaderboard shifts create the same dopamine loop that keeps you coming back. (Nir Eyal, Hooked)
  • The KΓΆhler Effect β€” People work harder in groups than alone, especially when they know their effort is visible. Research shows 3Γ— more consistency when peers are watching.
  • Small Group Dynamics β€” Dunbar's research shows that accountability peaks in groups of 3-8 people. Too small = no pressure. Too large = anonymity. Only Friends optimizes for this sweet spot.

The Flywheel

You complete a task  β†’  Friend sees it  β†’  Friend feels motivated  β†’  
Friend completes a task  β†’  You see it  β†’  You feel motivated  β†’  ∞

This is the infinite social loop. Each action compounds. The group gets stronger, not weaker, over time.


Tech Stack

Layer Technology
Framework React Native / Expo
Routing Expo Router (file-based)
State TanStack Query, Zustand
Icons Lucide React Native
Styling React Native StyleSheets (Custom Dark Theme)
Fonts Poppins, Inter (Google Fonts)
Landing Page Vanilla HTML, CSS, JS
Platform iOS, Android, Web (single codebase)

Installation & Setup

Prerequisites

1. Clone the Repository

git clone https://github.com/ishaaqdev/OnlyFriends.git
cd OnlyFriends

2. Install Dependencies

cd apps/mobile
npm install

3. Run the Mobile App (Web)

npx expo start --web --port 8100

The app will be available at http://localhost:8100.

4. Run the Landing Page

From the project root:

# Using Python
python -m http.server 8000 --directory docs

# Or using npx
npx serve docs

Open http://localhost:8000 in your browser. The landing page includes an interactive iframe that connects to the running Expo app.

5. Run on Mobile (Optional)

# iOS Simulator
npx expo start --ios

# Android Emulator
npx expo start --android

# Expo Go (scan QR code)
npx expo start

Folder Structure

OnlyFriends/
β”œβ”€β”€ docs/                         # Landing page
β”‚   └── index.html                # Responsive website with dark/light mode
β”œβ”€β”€ media/                        # Static assets
β”‚   └── images/                   # Team avatars, screenshots
β”œβ”€β”€ apps/                         # Application source
β”‚   └── mobile/                   # Expo / React Native project
β”‚       β”œβ”€β”€ src/
β”‚       β”‚   β”œβ”€β”€ app/              # File-based routing (Expo Router)
β”‚       β”‚   β”‚   β”œβ”€β”€ (tabs)/       # Tab screens (Home, Tasks, Friends, Profile)
β”‚       β”‚   β”‚   β”œβ”€β”€ notifications.jsx
β”‚       β”‚   β”‚   └── ...
β”‚       β”‚   β”œβ”€β”€ components/       # Reusable UI components
β”‚       β”‚   └── utils/            # Theme, helpers
β”‚       β”œβ”€β”€ polyfills/            # Web compatibility polyfills
β”‚       └── package.json
β”œβ”€β”€ README.md
└── LICENSE                       # MIT License

Screenshots

Home Friends Profile
Dashboard with streak Leaderboard & friends Stats & achievements

Creators

Built in 48 hours at the ZeroOne Hackathon by three friends who lived the accountability experiment firsthand.

Name GitHub LinkedIn
πŸ§‘β€πŸ’» Mohammed Ishaaq ishaaqdev ishaaq42
πŸ§‘β€πŸ’» D Karthik Raj dkarthikraj d-karthik-raj
πŸ§‘β€πŸ’» Ullas M ullasroxx ullas-m-naik

License

This project is licensed under the MIT License. See LICENSE for details.

About

OnlyFriends is a casual, friend-focused productivity and collaboration app inspired by platforms like Slack, but designed for close circles. It helps friends assign tasks, track progress, communicate easily, and stay connected through a clean, mobile-first social workspace experience.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors