OneSocial

Made by: Pierre Mvita
Date: 01/2025
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

This project is a cross-platform Social media, messaging, and crypto wallet app built using React Native and Expo. It features:

• Full authentication system using Supabase
• Real-time messaging capabilities
• Integrated crypto wallet functionality
• Customizable user profiles
• Dark/Light theme support
• Animated UI components
• Cross-platform compatibility (iOS & Android)
• Accessibility features
• Push notifications

Recent Updates:

• Added theme context for dynamic theming
• Implemented animated feed components
• Enhanced accessibility with ARIA labels and roles
• Added profile image handling
• Improved post interaction UI
• Added real-time updates for posts and messages

(back to top)

Built With

• 
• 
• 
• 

(back to top)

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

• Node.js

  node -v

• npm

  npm install npm@latest -g

• Yarn

  yarn -v

Installation

1. Clone the repo

   git clone https://github.com/Pmvita/OneSocial-supabase.git

2. Install Yarn packages

   yarn install

3. Change git remote url to avoid accidental pushes to base project

   git remote set-url origin github_username/repo_name
   git remote -v # confirm the changes

4. Configure environment variables:
   • Create a .env file in the root directory
   • Add your Supabase configuration:

     SUPABASE_URL=your_supabase_url
     SUPABASE_ANON_KEY=your_anon_key
     

5. Start the app

   yarn start

(back to top)

Usage

For more examples, please refer to the Documentation

(back to top)

Roadmap

• Feature 1: Authentication
  • Implemented Supabase email and password authentication
  • Added social authentication options
  • Secure session management
• Feature 2: Real-time Database
  • Real-time updates for posts and messages
  • Optimistic UI updates
  • Offline data persistence
• Feature 3: Crypto Wallet
  • Integrated wallet functionality
  • Real-time balance updates
  • Transaction history
  • Secure storage
• Feature 4: Notifications
  • Push notifications using Expo
  • In-app notifications
  • Custom toast notifications
• Feature 5: Cloud Functions
  • Serverless functions for complex operations
  • Automated tasks and triggers
• Feature 6: Image Upload
  • Profile picture upload and management
  • Post image handling
  • Image optimization
• UI Features:
  • Implemented React Animated components
  • Added CSS animations & transitions
  • Created custom loader components
  • Designed bottom tab navigation
  • Integrated vector icons
  • Added theme support
  • Enhanced accessibility

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Top contributors:

Contact

Pierre Mvita - @twitter_handle - [email protected]

Project Link: https://github.com/Pmvita/OneSocial-supabase.git

(back to top)

Acknowledgments

• React Native Documentation
• Expo Documentation
• Supabase Documentation

(back to top)