Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/geekelo/recalc-webapp

The ReCalc WebApp aims to provide users with a user-friendly and efficient calculator tool accessible through their web browser. React JS, known for its simplicity and component-based architecture, allows for the creation of interactive and responsive user interfaces, making it an ideal choice for this project.
https://github.com/geekelo/recalc-webapp

reactjs rest-api spa

Last synced: about 1 month ago
JSON representation

The ReCalc WebApp aims to provide users with a user-friendly and efficient calculator tool accessible through their web browser. React JS, known for its simplicity and component-based architecture, allows for the creation of interactive and responsive user interfaces, making it an ideal choice for this project.

Awesome Lists containing this project

README

        



signature


# πŸ“— Table of Contents

- [πŸ“— Table of Contents](#-table-of-contents)
- [πŸ“–THE RECALC WEBAPP](#the-recalc-webapp)
- [πŸ›  Built With ](#-built-with-)
- [Tech Stack ](#tech-stack-)
- [Key Features ](#key-features-)
- [πŸš€ Live Demo ](#-live-demo-)
- [πŸ’» Getting Started ](#-getting-started-)
- [Setup ](#setup-)
- [Prerequisites ](#prerequisites-)
- [Install ](#install-)
- [Usage ](#usage-)
- [Run Tests ](#run-tests-)
- [Deployment ](#deployment-)
- [πŸ‘₯ Authors ](#-authors-)
- [πŸ‘₯ Contributor ](#-contributor-)
- [🀝 Contributing ](#-contributing-)
- [Future Features ](#future-features-)
- [⭐️ Show your support ](#️-show-your-support-)
- [πŸ™ Acknowledgments ](#-acknowledgments-)
- [πŸ“ License ](#-license-)

![image](https://github.com/geekelo/recalc-webapp/assets/102464578/1d6b148a-cf29-4b58-aaa9-f92c7e7e8fa5)

# πŸ“–THE RECALC WEBAPP

**The RECALC WebApp** is a single-page application developed using React JS technology. It aims to provide users with a user-friendly and efficient calculator tool accessible through their web browser. React JS, known for its simplicity and component-based architecture, allows for the creation of interactive and responsive user interfaces, making it an ideal choice for this project.

Head to the LIVE DEMO SECTION for Live links and presentations

## πŸ›  Built With

### Tech Stack

ES6

HTML

CSS

JavaScript

REACT

### Key Features

- **Mobile Friendly** : this website performs well on a mobile device like a phone or tablet.
- **Desktop Friendly**: this website is responsive to desktop screen sizes.
- **Simple and Attractive Design** : the UI / UX is engaging and appealing.
- **Functional** : this website is accessible, easy to navigate, and helpful for users.
- **Animations and transitions : This website has engaging transitions and animations that makes it easier to use, smoother and more natural.

(back to top)

## πŸš€ Live Demo

> View the live demo of this project by clicking the text below.

- [See Live Demo via Github pages](https://geekelo.github.io/recalc-webapp/)
- [See Live Demo via Render](https://recalc-webapp.onrender.com/)

(back to top)

## πŸ’» Getting Started

To get a local copy up and running, follow these steps.

> Clone the repository
```
git clone https://github.com/geekelo/recalc-webapp.git
```
> And you are ready to begin your project

### Setup
This project contains
An HTML FILE (free to edit) - file that contains html codes to give structure to the main webpage
A CSS FILE (free to edit) - file that contains css codes to style the webpage
A GIT IGNORE FILE (free to edit) - to hide personal or private files
HTML/CSS LINTER FILES (should not edit) - Do not make changes
A JAVASCRIPT FILE (free to edit) - that handles functionalities and dynamic HTML

### Prerequisites
> You should have Node and Git Installed
> You should have basic knowledge on HTML / CSS / JavaScript
> You should have a code editor

### Install

> Download install [VSCODE](https://code.visualstudio.com/) and [Git](https://git-scm.com/)
> To install linters, execute the following commands:
```
Initialize npm | ``` npminit -y ```
HTML | ``` npm install --save-dev [email protected] ```
CSS | ```npm install --save-dev [email protected] [email protected] [email protected] [email protected] ```
```
### Usage
To run the linters, execute the following command and fix linter errors:
```
HTML | ``` npx hint . ```
CSS | ```npx stylelint "**/*.{css,scss}" ```
If you get a flood of errors keep in mind that linters guide you in writing a clean code!
```
### Run Tests
You can run this program on your browser

### Deployment

You can deploy this project using the following procedure:

- Pick the right hosting provider.
- Choose the tool and method to upload your website.
- Upload files to your website.
- Move the website files to the main root folder.
- Import your database.
- Check if your website works worldwide.

(back to top)

## πŸ‘₯ Authors

(back to top)

πŸ‘€ **Eloghene Otiede**

- GitHub: [@geekelo](https://github.com/geekelo)
- Twitter: [@Geekelo_xyz](https://twitter.com/Geekelo_xyz)
- LinkedIn: [LinkedIn](https://linkedin.com/in/eloghene-otiede)

(back to top)

## πŸ‘₯ Contributor

πŸ‘€ **Robert Mbugua**

- GitHub: [@Kanyorok](https://github.com/Kanyorok)
- Twitter: [@CarlosMbugua](https://twitter.com/CarlosMbugua)
- LinkedIn: [Robert Mbugua](https://www.linkedin.com/in/robert-mbugua-a8745093/)

(back to top)

## 🀝 Contributing

You can offer Contributions, submit an [issue](../../issues/), and make a feature request.

## Future Features

- Add pop up modals
- Add the contact form
- Add more content pages

## ⭐️ Show your support

> Please give a ⭐️ to support this project

(back to top)

## πŸ™ Acknowledgments

> I would like to thank Microverse for inspiring this project
> Fonts: [Google Fonts](https://fonts.google.com/)

(back to top)

## πŸ“ License

This project is [MIT](./MIT.md) licensed.

(back to top)