https://github.com/chsdwn/freetogameapp

A mobile application that provides a list of free-to-play games.
https://github.com/chsdwn/freetogameapp

react-native typescript

Last synced: about 2 months ago
JSON representation

A mobile application that provides a list of free-to-play games.

Host: GitHub
URL: https://github.com/chsdwn/freetogameapp
Owner: chsdwn
License: mit
Created: 2023-07-05T15:55:54.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2025-04-26T07:56:13.000Z (about 1 year ago)
Last Synced: 2025-04-26T08:32:59.643Z (about 1 year ago)
Topics: react-native, typescript
Language: TypeScript
Homepage:
Size: 8.29 MB
Stars: 2
Watchers: 1
Forks: 3
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

FreeToGameApp

A mobile application that provides a list of free-to-play games.

Report Bug
·
Request Feature

Table of Contents

About The Project
- Tech Stack

Getting Started
- Prerequisites
- Installation

License

Contact

Acknowledgments

## About The Project

A mobile application that provides a list of free-to-play games.

### Demo

https://github.com/chsdwn/FreeToGameApp/assets/13810855/2f7af9e8-e4d0-4d3e-adb3-52977cb0db3a

### Screenshots

#### List of Games

![List of free games](./screenshots/home.jpeg 'List of free games')

#### Filter

![List of free games](./screenshots/filter.jpg 'List of free games')

#### Loading

![Loading skeleton](./screenshots/skeleton.jpg 'Loading skeleton')

### Tech Stack

| Library | Category | Version | Description |
| ----------------------------------- | ---------------- | ------- | -------------------------------------------------------------------------------- |
| React Native | Mobile Framework | v0.72 | The best cross-platform mobile framework |
| React | UI Framework | v18 | The most popular UI framework in the world |
| TypeScript | Language | v4 | Static typechecking |
| React Navigation | Navigation | v6 | Performant and consistent navigation framework |
| React Native Paper | UI | v5 | Material Design for React Native |
| React Native Responsive Scalability | UI | v1 | Utility hooks for scalability |
| React Native Vector Icons | UI | v9 | Customizable icons |
| Zustand | State Management | v4 | A small, fast and scalable bearbones state-management solution |
| TanStack Query | State Management | v4 | Powerful asynchronous state management, server-state utilities and data fetching |
| axios | REST client | v1 | Communicate with back-end |
| Flipper | Debugger | | Native debugging |
| Hermes | JS engine | | Fine-tuned JS engine for RN |
| Jest | Test Runner | v29 | Standard test runner for JS apps |

(back to top)

## Getting Started

### Prerequisites

- React Native Development Environment

Please follow the guide to set up your development environment. https://reactnative.dev/docs/environment-setup?guide=native

- yarn
```sh
npm i -g yarn
```

### Installation

1. Clone the repo
```sh
git clone https://github.com/chsdwn/FreeToGameApp
```
1. Navigate to the FreeToGameApp directory
```sh
cd FreeToGameApp
```
1. Install NPM packages
```sh
yarn
```
1. (MacOS only) Install Cocoa packages
```sh
npx pod-install
```
1. Start metro server
```js
yarn start
```
1. Start application
1. Android
```sh
yarn android
```
1. iOS
```sh
yarn ios
```