Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sarkartanmay393/cryptoconvert

A web application that allows users to convert amounts from different cryptocurrencies to fiat currencies.
https://github.com/sarkartanmay393/cryptoconvert

expressjs jest reactjs shadcn-ui

Last synced: 19 days ago
JSON representation

A web application that allows users to convert amounts from different cryptocurrencies to fiat currencies.

Host: GitHub
URL: https://github.com/sarkartanmay393/cryptoconvert
Owner: sarkartanmay393
Created: 2023-12-29T19:02:31.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-01-05T10:37:47.000Z (about 1 year ago)
Last Synced: 2024-05-01T19:52:37.776Z (9 months ago)
Topics: expressjs, jest, reactjs, shadcn-ui
Language: TypeScript
Homepage: https://cryptoconvert.vercel.app
Size: 398 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        






  

    

  

CryptoConvert


[![Forks][forks-shield]][forks-url]

[![Stargazers][stars-shield]][stars-url]

[![Issues][issues-shield]][issues-url]

[![LinkedIn][linkedin-shield]][linkedin-url]



   A web application that allows users to convert amounts from different cryptocurrencies to fiat currencies

   


   Explore Code »

   


   


   View Demo

   ·

   Report Bug

   ·

   Request Feature

 



CryptoConvert is a web application that enables users to convert amounts various cryptocurrencies to fiat currencies. The application utilizes real-time exchange rates obtained from popular cryptocurrency data providers to perform accurate and up-to-date conversions.

  Table of Contents

  


    

      About The Project

      

        Feautures

      

      

        Technologies I Used

      

      

        Folder Structure

      

      

        Screenshots

      

    

    

      Getting Started

      

        Prerequisites

        Steps to run

      

    

    Contributing

    Contact

  


## About The Project

### Features

- Select a source cryptocurrency from a list of top 100 cryptocurrencies.

- Input the amount to be converted.

- Choose the target currency (USD, EUR, etc.).

- View the converted amount instantly.

### Technologies Used

- **Backend**: Node.js, Express.js

- **Frontend**: React

- **API**: Coinmarketcap (for fetching real-time exchange rates)

## Folder Structure

The project follows a structured organization with separate backend and frontend directories:

- `backend/`: Contains the Node.js backend.

- `frontend/`: Contains the React frontend.

### Screenshots

   Show 

  
 Mobile View



![Mobile View](screenshots/phone.png "Mobile View")

  
 Desktop View



![Desktop View](screenshots/desktop.png "Desktop View")

(back to top)


## Getting Started

Running a development environment for this project will be the easiest thing in you day.

### Prerequisites

- [**Node**](https://nodejs.org/en/)

### Steps to run

To run the application locally, follow these steps:

1. Clone the repository:

   ```bash

   git clone https://github.com/sarkartanmay393/--.git

   ```

2. Run both command separately to setup the codebase:

   ```bash

   cd backend && pnpm install && pnpm run dev

   ```

   ```bash

   cd frontend && pnpm install && pnpm run dev

   ```

- or Use Docker Compose

  ```bash

  docker compose up

  ```

- or Run the following command to start using `concurrently`

  ```zsh

  chmod +x quickStart.sh

  /.quickStart.sh

  ```




> If any issue occured ...

(back to top)


## Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

Don't forget to give the project a star! Thanks again!

1. Fork the Project

2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)

3. Commit your Changes (`git commit -s -m 'Add some AmazingFeature'`)

4. Push to the Branch (`git push origin feature/AmazingFeature`)

5. Open a Pull Request

6. Wait for review

See the [open issues](https://github.com/sarkartanmay393/CryptoConvert/issues) for a full list of proposed features (and known issues).

## Contact

Your Name - Tanmay Sarkar [@sarkartanmay393](https://twitter.com/sarkartanmay393) - [[email protected]](mailto:[email protected])

Project Link: [https://github.com/sarkartanmay393/CryptoConvert](https://github.com/sarkartanmay393/CryptoConvert)

**Thanks for visiting my project. If you like it, please give it a star. It will help me a lot. Thanks again!**

(back to top)


[forks-shield]: https://img.shields.io/github/forks/sarkartanmay393/CryptoConvert.svg?style=for-the-badge

[forks-url]: https://github.com/sarkartanmay393/CryptoConvert/network/members

[stars-shield]: https://img.shields.io/github/stars/sarkartanmay393/CryptoConvert.svg?style=for-the-badge

[stars-url]: https://github.com/sarkartanmay393/CryptoConvert/stargazers

[issues-shield]: https://img.shields.io/github/issues/sarkartanmay393/CryptoConvert.svg?style=for-the-badge

[issues-url]: https://github.com/sarkartanmay393/CryptoConvert/issues

[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555

[linkedin-url]: https://linkedin.com/in/tanmaysrkr

[React.dev]: https://img.shields.io/badge/React-2496ed?style=for-the-badge&logo=react&logoColor=white

[React-url]: https://www.docker.com/

[Express.com]: https://img.shields.io/badge/Express-2496ed?style=for-the-badge&logo=express&logoColor=white

[Express-url]: https://www.docker.com/

[Node.com]: https://img.shields.io/badge/Nodejs-2496ed?style=for-the-badge&logo=nodejs&logoColor=white

[Node-url]: https://www.docker.com/