Skip to content

Harkor421/Stardeos-Frontend-RN

Repository files navigation

Stardeos

Stardeos

A video streaming platform built for Dalas Review

React Native Expo Platform License Version


A cross-platform mobile streaming application built for Dalas Review — one of the largest Spanish-speaking YouTubers. Stardeos is a fully independent video platform where creators upload content, interact with their audience through live streams, and build communities outside of traditional social media.

This repository contains the React Native mobile client powering the iOS and Android apps.

Overview

Stardeos gives creators and viewers a platform free from the constraints of mainstream video hosting. The app features video browsing, live streaming with real-time chat, a virtual currency system (Stardust), channel subscriptions, and a full social layer with comments, likes, and shares.

Features

  • Video Feed — Infinite-scroll feed with randomized and chronological sorting
  • Video Player — Full playback with landscape/fullscreen support
  • Live Streaming — Real-time streams with WebSocket-powered live chat
  • Stardust Economy — Virtual currency for tipping creators and engaging with content
  • Channel Subscriptions — Follow creators and receive push notifications for new uploads
  • Comments & Interactions — Like, dislike, comment, share, and report content
  • Creator Profiles — Dedicated profile pages with subscriber counts and video catalogs
  • Search — Full-text video search across the platform
  • Notifications — Real-time notification system for follows, replies, and donations
  • Discord Integration — Link accounts with Discord for cross-platform identity
  • Monetization — Ad integration via Google AdMob with banner placements

Tech Stack

Layer Technology
Framework React Native 0.74 + Expo SDK 51
Navigation React Navigation 6 (Stack, Bottom Tabs, Material Top Tabs)
Networking Axios / Apisauce
Real-time Socket.io Client
Auth JWT with Expo Secure Store
Video expo-av, react-native-video
Forms Formik + Yup
Animations Lottie
Ads react-native-google-mobile-ads
UI Expo Linear Gradient, React Native SVG, Material Icons

Project Structure

app/
├── api/              # API service layer (auth, videos, streams, subscriptions, etc.)
├── auth/             # Authentication context and secure token storage
├── assets/           # Images, icons, and Lottie animations
├── components/
│   ├── forms/        # Reusable Formik form components
│   ├── navigation/   # Navigator configs, header, route constants
│   └── ...           # Shared UI components (modals, buttons, cards, etc.)
├── config/           # Colors and global styles
├── hooks/            # Custom hooks (API calls, formatting, subscriptions)
└── screens/          # All application screens

Getting Started

Prerequisites

  • Node.js 18+
  • Expo CLI
  • Android Studio (for Android) or Xcode (for iOS)

Installation

git clone https://github.com/Harkor421/Stardeos-Frontend-RN.git
cd Stardeos-Frontend-RN
npm install

Running the App

# Start the development server
npm start

# Run on Android
npm run android

# Run on iOS
npm run ios

The app uses expo-dev-client and requires a development build. Run npx expo prebuild before the first launch on a physical device or emulator.

Architecture

The app follows a straightforward React Native architecture:

  • Auth flow — JWT tokens stored in expo-secure-store, managed via React Context. All API requests inject the bearer token automatically through an Axios interceptor.
  • Navigation — Conditional rendering between AuthNavigator (login) and AppNavigator (main app) based on auth state. The main app uses bottom tabs with nested stack navigators.
  • API layer — Centralized Axios client with per-domain service modules. A custom useApi hook handles loading and error states for all network calls.
  • Real-time — Live stream chat runs over Socket.io with event-based message handling.

License

This project is licensed under the MIT License — see the LICENSE file for details.

Copyright (c) 2024 Samir Gonzalez

About

Cross-platform mobile client for Stardeos — an independent video streaming platform built with React Native & Expo

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors