Skip to content

OxyHQ/MentionReact

Repository files navigation

Mention React Client

A cutting-edge social media client, built with React Native and TypeScript.


Mention

Mention is an innovative social media client designed to connect users and facilitate engaging conversations. With a focus on modern technologies, seamless user experience, and community-driven development, Mention aims to redefine social interactions online.

Join us in shaping the future of social media!

Project Overview

Mention is not just another social media app; it's a dynamically evolving project built with the latest technologies to provide a rich, engaging, and user-friendly experience. Here’s what makes Mention stand out:

Purpose

Our goal is to create a modern, scalable, and accessible social media client that fosters genuine connections and engaging interactions. Mention is designed to provide users with a platform that’s more intuitive, inclusive, and enjoyable.

Key Features

  • Engaging Interactions: Facilitate likes, comments, reposts, and more.
  • User Profiles: Personalize your profile, share your story, and connect with others.
  • Explore: Discover new content, trending topics, and interesting users.
  • Notifications: Stay updated with the latest activities and interactions.
  • Direct Messaging: Connect with friends and other users via private messaging.
  • Customizable Settings: Tailor your experience with account, display, and notification settings.
  • Bookmarks: Save your favorite posts.
  • Lists: Create, share, and follow lists.

Technologies Used

  • React Native: For building cross-platform mobile applications with a single codebase.
  • TypeScript: Adding static typing to our codebase, ensuring robustness and maintainability.
  • Expo: Accelerating the development process with its set of tools and services.
  • File-Based Routing: Simplified navigation management using the directory structure.
  • React Navigation: Handling navigation between different screens and components.
  • Redux Toolkit: Managing application state effectively.
  • Vercel: Deployment and hosting for the web version.
  • Sonner: Displaying toasts and notifications.

Setup and Usage

Prerequisites

  • Node.js and npm installed on your machine.
  • Expo CLI (npm install -g expo-cli)
  • A code editor (like VS Code).
  • An Android or iOS device/emulator for testing.

Installation

  1. Clone the repository:

Table of Contents

Get started

  1. Install dependencies

    npm install
  2. Start the app

     npx expo start

In the output, you'll find options to open the app in a

You can start developing by editing the files inside the app directory. This project uses file-based routing.

Contributing

We welcome contributions from everyone! If you're interested in contributing to Mention, please take a look at our contribution guidelines.

How to Contribute

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Commit your changes with descriptive commit messages.
  4. Push your changes to your forked repository.
  5. Submit a pull request to the main repository.

Get a fresh project

When you're ready, run:

npm run reset-project

This command will move the starter code to the app-example directory and create a blank app directory where you can start developing.

Learn more

To learn more about developing your project with Expo, look at the following resources:

Join the community

Join our community of developers creating universal apps.