Skip to content

InternetHealthReport/ihr-website

Repository files navigation

IHR Website

The Internet Health Report monitors the conditions of networks that compose the Internet. This effort aims to provide network operators, policymakers, and other stakeholders, with a better understanding of the Internet's infrastructure and its evolution. To understand further click here.

Prerequisites to run

Install Node JS

Install Node v20.10.0 (LTS)

Install npm package manager

Install Npm v10.2.4

Cloning and Running the Application in local

Clone the project in localhost

git clone https://github.com/InternetHealthReport/ihr-website.git
cd ihr-website

Note:

  • you can use nvm to switch between node versions as per your need

Install all the npm packages. Go to root directory and type the following command to install all npm packages

npm install

For compilations and hot-reloads in development

npm run dev

To compile and minify for production run

npm run build

To lints and fixes files

npm run lint

Deploy with Docker

To deploy the project with Docker, follow these steps:

Clone the project in localhost

git clone https://github.com/InternetHealthReport/ihr-website.git
cd ihr-website

Build the Docker Image

docker build -t ihr-website .

Run the Docker Container

docker run --name ihr-website -d -p <host-port>:80 -t ihr-website

Replace <host-port> with the port on your host machine where you want to expose the application.

Ways to contribute

First off, thanks for taking the time to contribute! 🎉🎉

When contributing to this repository, please first discuss the change you wish to make via issue with the maintainers of this repository before making a change. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.

  1. Solve the issues which are listed
  2. Create your own issue and then send PR.

Please refer to the project's style and contribution guidelines for submitting patches and additions. In general, we follow the "fork-and-pull" Git workflow. The basic workflow:

  1. Fork the repo on GitHub
  2. Clone the project to your own machine
  3. Create a branch and name it with the issue number
  4. Commit changes to the branch
  5. Push your work back to your fork
  6. Rebase your branch with the dev branch
  7. Submit your Pull Request so that we can review it

Please submit your issues and pull request while following the automated template. During the contributing phase abide by the Contributing Guidelines and Code of Conduct.