Skip to content

Latest commit

 

History

History
112 lines (73 loc) · 2.85 KB

Learn.md

File metadata and controls

112 lines (73 loc) · 2.85 KB
Raw

Introduction

This project is a URL Shortener application that allows users to enter a long URL, which is then shortened to a much shorter URL that can be easily shared. The shortened URL is redirectable to the original long URL.

Table of Contents

Technologies

The project utilizes the following technologies:

  • Backend:

    • NodeJS: A JavaScript runtime for building server-side applications.
    • ExpressJS: A lightweight framework for building web applications.
    • MongoDB: A document-oriented NoSQL database.

  • Frontend:

    • React.js: A JavaScript library for building ui components.

Application Setup

To setup the application locally, follow these steps:

  1. Star and Fork this repo to create your own copy to work from.

  2. Clone the repository you forked to your local machine using:

       git clone <your_forked_repo_url>

  3. Navigate to the Server directory using command "cd server" and create a .env file and copy contents of .env.example file to .env file and add all secret keys to setup MongoDB database.

  4. Install dependencies in server directory of project:

       npm install

  5. Start the server using command:

       npm start

  6. Now navigate to client directory of project using commands:

       cd ../client

  7. Install dependencies in client directory of project:

       npm install

  8. Start the application using command:

       npm start

  9. Open http://localhost:3000 in your browser to see the application.


How to Contribute

Contributions are welcome! If you would like to contribute to the project, please follow these steps:

  1. Clone and setup this application locally by following above application setup steps.

  2. Create a new branch for the issue you assigned to work on, using below command:

       git checkout -b your_branch_name

  3. Make your changes to the code.

  4. Once you are satisfied with your changes, commit them with a descriptive commit message using below command:

       git add .
   git commit -m "feat: Add feature X"

  5. Push your changes to your forked repository:

       git push origin your_branch_name

  6. Create a pull request by clicking the "Pull request" button on the original repository page.

  7. Wait for the project maintainer to review your pull request and provide feedback.

  8. If your pull request is accepted, it will be merged into the main branch of the project. Congratulations, you've contributed to the project!


Code Style

  • Please make sure to follow the existing code style and formatting conventions when making contributions to the project.