TradeApollo Dashboard is a Next.js-based dashboard application that allows users to explore residential electricity prices and carbon intensity data across different countries and regions. The application utilizes various APIs to fetch real-time data and provides an interactive map interface for easy navigation.
- Interactive world map displaying electricity zones and countries
- Real-time residential electricity price search based on country, zipcode, and total kW usage
- Live carbon intensity data for selected electricity zones
- Live power breakdown by source for selected electricity zones
- Historical pricing data visualization with line charts
- Export pricing data as CSV
- Responsive design for seamless usage across devices
- Next.js: A React framework for building server-side rendered and static web applications
- React: A JavaScript library for building user interfaces
- TypeScript: A typed superset of JavaScript that compiles to plain JavaScript
- Mapbox GL JS: A JavaScript library for interactive, customizable vector maps
- react-map-gl: A React wrapper for Mapbox GL JS
- Recharts: A composable charting library built on React components
- NextUI: A beautiful, fast, and modern React UI library
- Tailwind CSS: A utility-first CSS framework for rapidly building custom user interfaces
- Framer Motion: A production-ready motion library for React
- Moment.js: A JavaScript library for parsing, validating, manipulating, and formatting dates
To run the TradeApollo application locally, follow these steps:
- Clone the repository:
git clone https://github.com/your-username/tradeapollo.git- Install the dependencies:
cd tradeapollo
npm install- Set up the required environment variables:
- Create a
.env.localfile in the root directory of the project - Add the following variables:
NEXT_PUBLIC_MAPBOX_TOKEN=your_mapbox_token
- Start the development server:
npm run dev- Open your browser and navigate to
http://localhost:3000to see the application.
The TradeApollo application relies on the following API endpoints:
- Residential Electricity Prices: You need to run the backend API program.
- Carbon Intensity Data:
https://api.electricitymap.org/v3/carbon-intensity/latest - Power Breakdown Data:
https://api.electricitymap.org/v3/power-breakdown/latest - Historical Pricing Data: You need to run the backend API program.
Make sure you have the necessary API tokens and permissions to access these endpoints.
Contributions to TradeApollo are welcome! If you encounter any issues or have suggestions for improvements, please open an issue on the GitHub repository. If you'd like to contribute code changes, please follow these steps:
- Fork the repository
- Create a new branch for your feature or bug fix
- Make your changes and commit them with descriptive commit messages
- Push your changes to your forked repository
- Open a pull request to the main repository, describing your changes in detail
This project is licensed under the MIT License. See the LICENSE file for more information.