jtvargas / stocks-rn

Simple Stocks app built with RN

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Stocks & Watchlist App: React Native App

Mobile application developed with React Native.

An app that connects with Finnhub API to allow users to search for stocks, add them to a watchlist, and create price alerts for stocks.

Table of Contents

Screenshots (iOS)

    

Screenshots (Android)

    

Structure

  • components: Essential, reusable building blocks like the stock card and dropdown.
  • app: Where the tabs and layout is placed, using expo-router
  • hooks: Reusable hooks to connect the app with the Finnhub API endpoints and handle real-time data.
  • utils: Utility functions, such as storage utilities for persistent state.
  • context: React context files.

Features

The current application offers:

  • Stock Search: Search for stocks using the Finnhub API.
  • Watchlist Management: Add stocks to a watchlist and remove them as needed.
  • Price Alerts: Create price alerts for stocks and receive notifications when the stock price exceeds the alert price.
  • Real-time Data: Receive real-time stock data updates from Finnhub.

Prerequisites

Ensure you have met the following requirements:

  • You have installed the latest version of:
    • yarn
    • .nvmrc

Dependencies

The following major dependencies are used in the project:

  • React (react: 18.2.0)
  • React Native (react-native: 0.73.6) as the main frameworks for building the app interface.
  • Expo Development Build (more info: Expo Development Builds) for creating a custom development build.
  • GlueStack-io (more info: GlueStack.io) for UI components.
  • react-native-notifier (react-native-notifier: ^1.0.0) for in-app notifications.
  • Finnhub API (more info: Finnhub API) for stock data.

Installation

Describe the installation process. Include the step-by-step process.

# Clone this repository
$ git clone git@github.com:jtvargas/stocks-rn.git

# Go into the repository
$ cd stocks-rn

# Install dependencies
$ yarn install

# Start the server
$ yarn start

Prerequisites: Ensure your environment is set up for React Native development. Follow the Expo documentation for setting up development builds.

Run the app (Simulator)

iOS

  • Run yarn ios

For physical device use Xcode.

Android

  • Run yarn android

License

Copyright 2024 © Jonathan Taveras

About

Simple Stocks app built with RN


Languages

Language:TypeScript 79.2%Language:Kotlin 7.4%Language:Objective-C++ 4.8%Language:Ruby 4.0%Language:JavaScript 3.7%Language:Objective-C 0.6%Language:Swift 0.2%Language:C 0.2%