I describe AssetArc as a modern Android app for tracking Indian stocks and crypto assets with a dark-theme UI. Its README covers features, data sources, setup, examples, customization, future enhancements, contributing, licensing, acknowledgments, and support.
The README describes AssetArc as having Google Sign-In with Firebase, email/password login and signup, SMS-based phone authentication, and a dark-mode toggle with a radial reveal animation.
The README claims the app provides free, real-time Indian stock data with NSE and BSE support, top gainers and losers, market overviews, and stock search by symbol or name.
The README describes multi-asset portfolio tracking for stocks and cryptocurrencies, with real-time prices, total balance and individual holdings, and portfolio search and filtering.
The README says Yahoo Finance is the primary source for NSE stocks with .NS suffix; provides prices, volume, high/low, and open/close without an API key, with generous rate limits and claimed high accuracy.
The README says Alpha Vantage is a backup for global markets including NSE, provides OHLCV and technical indicators, and its free API-key tier is stated to allow 500 requests/day.
The README says NSE India is a market-reference and validation source; BSE India is used to cross-reference NSE data.
The README claims the app includes 50+ major Indian stocks and gives examples from NIFTY 50, banking and finance, technology, manufacturing and auto, and pharmaceuticals.
The README lists the dark-theme colors as Primary #3390EC; Background #17212B; Surface #232E3C; Text #FFFFFF; Secondary Text #AEBACB.
The README's build instructions are: git clone https://github.com/yourusername/AssetArc.git; cd AssetArc; ./gradlew build; ./gradlew installDebug.
The README's Firebase setup uses package com.example.assetarc, places google-services.json in app/, and enables Google Sign-In authentication.
The README gives IndianStockService examples that retrieve RELIANCE price, search TCS, and get top gainers.
The README provides a Yahoo Finance chart URL for RELIANCE.NS and an Alpha Vantage GLOBAL_QUOTE URL for RELIANCE.NS.
The README says to edit INDIAN_STOCKS and fetchFromYahooFinance()/fetchFromAlphaVantage() in IndianStockService.kt; customize themes in ui/theme/Color.kt and ui/theme/Theme.kt.
The README advises: Consider paid API plans for production for higher limits and better reliability because free APIs have rate limits.
The README lists these future enhancements as unchecked: real-time charts; technical indicators (RSI, MACD, Moving averages); news integration; watchlists; alerts; portfolio analytics; CSV/PDF data export; widgets.
The README also gives the optional Alpha Vantage property key ALPHA_VANTAGE_API_KEY, support email support@assetarc.com, and documentation URL https://docs.assetarc.com. It describes the project as MIT-licensed and acknowledges Yahoo Finance, Alpha Vantage, NSE India, BSE India, Firebase, and Jetpack Compose. Its clone URL contains the placeholder yourusername; the intended repository URL is not established by the supplied content.