Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dagmawi-22/retiktok


https://github.com/dagmawi-22/retiktok

Last synced: 12 days ago
JSON representation

Awesome Lists containing this project

README

        

# retiktok
## A simple Expo React Native app with a video watching feature with a swipe bottom/up handler in a way that tiktok and many video/reel sharing apps do.
![image](https://github.com/Dagmawi-22/retiktok/assets/109204719/fedab553-70de-4b88-bd97-31498e1b0742) ![image](https://github.com/Dagmawi-22/retiktok/assets/109204719/078c0bb6-65a7-478d-9b4b-41913eb3b87c) ![image](https://github.com/Dagmawi-22/retiktok/assets/109204719/8bea965c-6dc9-43b9-b9ad-ae4493bee491)

# Tools Used
- Expo - for development environment & testing
- expo-router from expo - for file based and easy routing between the screens in the app
- PanResponder from react-native - for handling the swipe up/bottom actions & switching videos
- Animated from react-native - for providing an animated style exchange for components
- expo-av - for playing videos
- expo-video-thumbnails - to generate thumbnails for videos

# How to Run

To run this project locally on your machine, follow these steps:

### Prerequisites

Make sure you have the following installed:
- Node.js
- npm or yarn
- Expo CLI (if not installed, you can install it globally using npm or yarn)
- expo-go app on your phone

### Clone the Repository

First, clone this repository to your local machine:
```bash
git clone https://github.com/Dagmawi-22/retiktok.git
```
then, cd into the repository folder:

```bash
cd retiktok
```
Then, install the required libraries:
```bash
yarn install
```
Finally, start the app:
```bash
npx expo start -c --tunnel
```

## tunnel mode is highly recommended to start as LAN mode often interrupts & make sure you installed @expo/ngrok library for tunnel mode to work

## finally scan the QR code in terminal window with your expo-go mobile app & look through. Thanks!