BelieveScreener React Native (Android/iOS)

A React Native app for Android and iOS, built for believescreener.com — part of the believe.app project

Bounty for CrackedDevs@SuperteamEarn

Previews

Demo Video

believescreener-bounty-demo @ veed.io

Mockups

Home Page	Token - Info	Token - Chart
Token - Holders (loading)	Token - Holders	Search - Portfolio
Portfolio	Search - Token	Favourites (empty)
Favourites

Tech Stack

Architecture

flowchart TD
    Start["Fetch Believe tokens & values from DEX"] --> App["Believe Screener App"]
    App --> Home["Home"] & Search["Search"] & Favourite["Favourite"]
    Search --> Wallet["Wallet (CA)"] & TokenKW["Token (keyword)"]
    Home --> TokenPg["token/{mintAddress}"]
    Favourite --> TokenPg
    TokenPg --> Info["Info (favourite, trade, CA copy)"] & Charts["Charts"] & Holdings["Holdings (holder list)"]
    Holdings --> Portfolio["portfolio/{walletAddress}"]
    TokenKW --> TokenPg
    Wallet --> Portfolio

Loading

Approach

How did I fetch the list of Believe Tokens?

I've mocked the list of tokens at believe-dummy-app (deployed-link), which gets the data of tokens from the believe.app/explore & the metrics dashboard is updated manually

External APIs

• Dexscreener API for token prices
• Moralis API for token holder list
• Helius API for portfolio of an address

All necessary API keys have been mentioned in .env.template

Get started

• Make sure you have Node 20.xx.x or higher and Git downloaded

1. Clone the repository

   git clone git@github.com:mathdebate09/believescreener.git
   cd believescreener

2. Set up .env

   • COPY .env.template to .env
   • Moralis API key from moralis/register
   • Helius API key from helius/signup -> helius/endpoints
     • *Only paste the alphanumeric string after https://mainnet.helius-rpc.com/?api-key= in the .env as Helius API key

3. Install dependencies

   npm install

4. Start the app

   npm run start

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

• Expo Go is the fastest way, but requires an Android/iOS device for their OS specific preview
• Android emulator
• iOS simulator

Contact

For any issue related to setup, don't hesitate to ask me! Telegram || X.COM