Smart Units Converter - Browser Extension

An extension that effortlessly converts your selected values into popular units, saving you time and making life easier. Plus, it includes powerful statistical analysis tools and personalized health reports to support your daily tasks and wellness goals! 💃

Click on the below to view the video

Play!!!

Use Cases

Convert $ to ¥ when you are shopping abroad
Convert kilometers to miles when you are planning routes before driving
Convert kilograms to pounds when you are buying food
Convert celcius to fahrenheit when you are talking about weather
Convert hours to seconds when you are calculating time
Convert celcius to Fahrenheit when you are calculating temperature
Convert Mb/s to b/s when you are calculating internet speed
Convert square meter to square feet when you are calculating the measure of area
Convert litres to gallons when you are calculating the volume for liquid items online
Convert TB to GB when you are buying data storage devices
Convert Time from a given time zone to another (PST to EST)
Automatically calculate mean, standard deviation, and entropy after entering a data set
Calculate BMI, BMR, and TDEE based on height, weight, age, and gender
Enable colorblind mode for accessibility
Voice Input For Selected Features (New Feature)
UI-Enhancements - Theme change and Dynamic Results(New Feature)
Custom Tab (New Feature)
Compound Calculations (New Feature)
Multilingual Support (New Feature)

Technologies we used:

Installation Guide

Step 1: Clone this Repository

git clone [repository_url]

Step 2: Go to chrome extensions

In the chrome browser open
```
chrome://extensions/
```
Step 3: Enable developer settings
Enable developer settings if it is not enabled

Step 4: Unpack the cloned repository

Choose Load Unpacked
Select the repository folder that was cloned in the first step

Step 5: Check the extension added

The extension will now be added to the Chrome

Step 6: Test the extension

Displays the most relevant converted unit first
Click on view all button to view all of the converted units for that metric

Popup Features for the user

To access the popup feature the user has to click on the extension icon in the top right corner where the user further finds and selects the extension "Unit Convert Selection"

1. Direct conversions

This feature allows the user to directly convert units without the need to select any particular text on the browser. This helps save trouble and effort for the user
The user selects the conversion he requires from the given standard conversions
Dark Mode:
The user can select and convert any unit to the required unit without any restrictions. This direct method allows the user to be quick

2. Customized Conversions

This feature allows the user to create his own customized unit conversion for his personal use and purposes. This includes all the conversion that are not standard but used as a jargon by people.
This example shows 1 meter is equal to 3 scale units
Since the customized version of conversion keeps changing it is important to allow the user to alter the units. So a feature is added that allows user to delete his customized conversion.

3. Favorites
This feature allows users to select a particular conversion unit and place it in favorites as the units in favorites are shown at the top. This feature is useful when the user wastes time in finding his desired converted unit from a pool of large units.
Here we select pint and gallon as favorites in volume converions.

4. Statistics

This feature allows the user to calculate mean, standard deviation, and entropy after entering a data set.

5. Health Reports

This feature allows the user to calculate BMI, BMR, and TDEE based on height, weight, age, and gender.

6. Compound Conversions

This feature allows a custom tab for calculating compounds, allowing users to perform specific calculations tailored to their needs.

7. Colorblind Mode

This feature allows the user to enable colorblind mode for accessibility.

Style Checker and Analyzer

Standard Js

Installation npm install standard --global in comand line interface to install globally npm install standard --save-dev in command line interface to install locally

Running Standard Js go to root of project and type standard if StandardJs is installed globally go to root of project and type npx standard if StandardJs is installed locally Instead of installing it using npm, you can also use the extension available on VS Code

IDE and Code Fomatter

IDE and Style Checker: VSCode
Code Style Formatter: Beautify
Code Syntax Checker : Eslint for Vscode plugin.

VS Code uses js-beautify internally, but it lacks the ability to modify the style you wish to use. This extension enables running js-beautify in VS Code, AND honouring any .jsbeautifyrc file in the open file's path tree to load your code styling. Run with F1 Beautify (to beautify a selection) or F1 Beautify file.

Run Test cases and coverage

Test Cases Guide

Unit Test

Test cases have been tested using Mocha and Chai.

Setup

From the repository root, run:
```
npm install --save-dev mocha chai
```

Then run:

    npm test [filename]

npm will then attempt to run all test files that end with *.test.js if you do not specify the filename.

Code Coverage

Istanbul and Coveralls

Funding

The project is not currently funded

🌠 Future

See RoadMap here

Documentation (Wiki)

"What" and "How" Docs

"Why" and "Why not" Docs

Think about the case when you shopping on Amazon. When you want to purchase Dumbbells on the website, the weight unit is somewhat you are not familiar with. You will google search the conversion of two units. But now, we have units converter, helping you to covert the unit by a single select with the mouse.

Feature Model

<!--  This model was created online using SPLOT's Feature Model Editor (http://www.splot-research.org) -->
<feature_model name="Unit Converter Extension">
    <feature_tree> 
        :r Unit Converter Extension(_r) 
            :m Length(_r_1) 
            :m Mass(_r_3) 
            :m Temperature(_r_4) 
            :m Time(_r_5) 
            :m Currency(_r_6) 
            :m Area(_r_7) 
            :m Datarate(_r_8) 
            :m Speed(_r_10) 
    </feature_tree>
    <constraints> 
        constraint_1:_r_1 or _r_7 
        constraint_2:_r_1 or _r_5 or _r_10 
    </constraints>
</feature_model>

feature_model

Troubleshooting

If you encounter any issues during any stage of extension use or you encounter any development-related issues, feel free to reach out to our contact our support team at unit.convertor.help@gmail.com.

Triad Triumph

CSC 510 - Software Engineering 2024
We are a group of 3 whose names start with S - Success. Hence, Triad Triumph - just like the alliteration in our names.

Contributors

Moto

Learning . Unlearning . Unleasing

SKS2024SE / Unit_Conversion_2024

readme