{"id":46367530,"url":"https://github.com/ktwu01/crypto-dashboard","last_synced_at":"2026-03-05T02:34:25.788Z","repository":{"id":319399163,"uuid":"1077936371","full_name":"ktwu01/crypto-dashboard","owner":"ktwu01","description":"AI-Powered Crypto Analysis Dashboard!","archived":false,"fork":false,"pushed_at":"2025-11-18T04:40:40.000Z","size":3884,"stargazers_count":14,"open_issues_count":12,"forks_count":7,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-18T06:21:29.491Z","etag":null,"topics":["ai","ai-agent","ai-bot","ai-crypto","ai-trade","crypto","crypto-bot","crypto-dashboard","cryptocurrencies","cryptocurrency","quant","quant-trading","tokenomics","trade-bot","trade-dashboard","tradeview","trading-dashboard"],"latest_commit_sha":null,"homepage":"https://ktwu01.github.io/crypto-dashboard/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ktwu01.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-17T00:59:14.000Z","updated_at":"2025-11-18T04:40:36.000Z","dependencies_parsed_at":"2025-10-19T01:48:15.020Z","dependency_job_id":null,"html_url":"https://github.com/ktwu01/crypto-dashboard","commit_stats":null,"previous_names":["ktwu01/crypto-dashboard"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ktwu01/crypto-dashboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ktwu01%2Fcrypto-dashboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ktwu01%2Fcrypto-dashboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ktwu01%2Fcrypto-dashboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ktwu01%2Fcrypto-dashboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ktwu01","download_url":"https://codeload.github.com/ktwu01/crypto-dashboard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ktwu01%2Fcrypto-dashboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30107261,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T01:39:18.192Z","status":"online","status_checked_at":"2026-03-05T02:00:06.710Z","response_time":93,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agent","ai-bot","ai-crypto","ai-trade","crypto","crypto-bot","crypto-dashboard","cryptocurrencies","cryptocurrency","quant","quant-trading","tokenomics","trade-bot","trade-dashboard","tradeview","trading-dashboard"],"created_at":"2026-03-05T02:34:25.297Z","updated_at":"2026-03-05T02:34:25.760Z","avatar_url":"https://github.com/ktwu01.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI-Powered Crypto Analysis Dashboard\n\n[![Website](https://img.shields.io/website?url=https%3A%2F%2Fktwu01.github.io%2Fcrypto-dashboard%2F)](https://ktwu01.github.io/crypto-dashboard/) [![GitHub stars](https://img.shields.io/github/stars/ktwu01/crypto-dashboard)](https://github.com/ktwu01/crypto-dashboard) [![GitHub forks](https://img.shields.io/github/forks/ktwu01/crypto-dashboard)](https://github.com/ktwu01/crypto-dashboard/fork) ![License](https://img.shields.io/badge/License-CC%20BY--NC--ND%204.0-lightgrey.svg)\n\n[![Build Status](https://img.shields.io/travis/com/ktwu01/crypto-dashboard.svg)](https://travis-ci.com/ktwu01/crypto-dashboard) [![Coverage Status](https://coveralls.io/repos/github/ktwu01/crypto-dashboard/badge.svg?branch=main)](https://coveralls.io/github/ktwu01/crypto-dashboard?branch=main) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n\n[![Twitter Follow](https://img.shields.io/twitter/follow/ktwu01?style=social)](https://twitter.com/ktwu01)\n\nA comprehensive cryptocurrency analysis and portfolio management dashboard built with React, TypeScript, and Vite. Track real-time crypto prices, market trends, and manage your portfolio with a beautiful, modern UI.\n\n\u003e We are truly thankful for the geek @Zillizezz and benefited greatly from the [Minimax hackathon](https://agent.minimax.io/share/300474460274837). @Zillizezz also allowed us to remix their project (crypto-dashboard) in the hackathon. Although we tried our best to find this username on the whole web, we could not find them on GitHub and so on, and failed to contact them. So we have to just use this new repo instead of forking one.\n\n![Dashboard Overview](docs/crypto-dashboard-dashboard.png)\n*AI Insights sit at the top of the streamlined dashboard, surfacing the latest market pulse alongside high-level performance tiles.*\n\n![Market Explorer](docs/crypto-dashboard-market.png)\n*Market view highlights gainers, losers, and trending coins while letting you drill into granular quote data with a responsive table layout.*\n\n![Advanced Charts](docs/crypto-dashboard-charts.png)\n*Interactive chart workspace combines multi-interval price action with technical overlays for deeper analysis.*\n\n## Features\n\n### Market Overview\n- **Real-time Price Tracking**: Live cryptocurrency prices from CoinGecko API\n- **Market Statistics**: Global market cap, 24h volume, and dominance metrics\n- **Trending Coins**: Discover the hottest cryptocurrencies\n- **Gainers \u0026 Losers**: Track top performing and declining assets\n\n### Portfolio Management\n- **Asset Tracking**: Add and manage your crypto holdings\n- **Portfolio Analytics**: View total value, profit/loss, and allocation\n- **Performance Metrics**: Track your investment performance over time\n\n### Advanced Charting\n- **Interactive Price Charts**: Visualize price movements with Chart.js\n- **Multiple Timeframes**: 24h, 7d, 30d, 90d, 1y, and max views\n- **Technical Indicators**: (Planned) MACD, RSI, Moving Averages\n\n### Modern UI/UX\n- **Glassmorphism Design**: Beautiful glass-effect cards and components\n- **Responsive Layout**: Works seamlessly on desktop and mobile\n- **Dark Theme**: Eye-friendly interface for extended use\n- **Smooth Animations**: Powered by Framer Motion\n\n## Quick Start\n\n### Prerequisites\n- Node.js 18+ \n- pnpm (recommended) or npm\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/ktwu01/crypto-dashboard.git\n   cd crypto-dashboard\n   ```\n\n2. **Install dependencies**\n   ```bash\n   pnpm install\n   ```\n\n3. **Set up environment variables**\n   ```bash\n   cp .env.example .env\n   ```\n   \n   The default configuration uses CoinGecko's free API:\n   ```env\n   VITE_API_BASE_URL=https://api.coingecko.com/api/v3\n   # Optional: supply a demo/pro key to raise rate limits and attach x_cg_demo_api_key automatically\n   # VITE_COINGECKO_API_KEY=your-demo-or-pro-key\n   ```\n\n4. **Start the development server**\n   ```bash\n   pnpm dev\n   ```\n\n5. **Open your browser**\n   \n   Navigate to [http://localhost:5173](http://localhost:5173)\n\n## Available Scripts\n\n- `pnpm dev` - Start development server (with HMR)\n- `pnpm build` - Build for production\n- `pnpm preview` - Preview production build locally\n- `pnpm lint` - Run ESLint to check code quality\n\n## Tech Stack\n\n- **Framework**: React 18 + TypeScript\n- **Build Tool**: Vite 6\n- **Styling**: Tailwind CSS + CSS Modules\n- **UI Components**: Radix UI + Custom Components\n- **Charts**: Chart.js + React-Chartjs-2\n- **Animations**: Framer Motion\n- **API Client**: Axios\n- **State Management**: React Query\n- **Routing**: React Router v6\n- **Form Handling**: React Hook Form + Zod\n\n## Configuration\n\n### API Configuration\nThe app uses CoinGecko's public API by default. No API key is required for basic usage.\n\nTo use a different API or endpoint:\n1. Update `.env` file:\n   ```env\n   VITE_API_BASE_URL=your_api_url_here\n   ```\n\n2. Restart the development server\n\n### Environment Variables\n- `VITE_API_BASE_URL` - Base URL for cryptocurrency API (default: CoinGecko)\n\n## Features Roadmap\n\n- [x] Real-time market data\n- [x] Portfolio management\n- [x] Interactive price charts\n- [x] Trending coins \u0026 market movers\n- [x] Technical analysis indicators\n- [x] Customizable watchlists\n- [ ] AI-powered market insights\n- [ ] User accounts \u0026 cloud sync\n- [ ] Mobile app (React Native)\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## License\n\nThis project is open source and available under the [MIT License](LICENSE).\n\n## Acknowledgments\n\n- [CoinGecko API](https://www.coingecko.com/en/api) for cryptocurrency data\n- [@Zillizezz](https://agent.minimax.io/share/300474460274837) for the original Minimax hackathon project\n- [Radix UI](https://www.radix-ui.com/) for accessible component primitives\n- [Tailwind CSS](https://tailwindcss.com/) for utility-first styling\n\n## Documentation\n\n- [Deployment Guide](./DEPLOYMENT.md) - Instructions for deploying to various platforms\n- [Project Plan](./.cursor/scratchpad.md) - Development roadmap and progress tracking\n\n## Support\n\nFor questions or issues, please [open an issue](https://github.com/ktwu01/crypto-dashboard/issues) on GitHub.\n\n---\n\nBuilt with React + TypeScript + Vite\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fktwu01%2Fcrypto-dashboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fktwu01%2Fcrypto-dashboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fktwu01%2Fcrypto-dashboard/lists"}