Skip to content

Latest commit

 

History

History
182 lines (124 loc) · 6.13 KB

Readme.md

File metadata and controls

182 lines (124 loc) · 6.13 KB
Raw

URL Shortener App


⚡ About Us:

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.

⚡Tech Stack:


Tailwind CSS TypeScript Node.js Express Next.js mongoDB

⚡Table of Contents:

Features

  1. URL shortening: Users can enter a long URL and get a shortened URL that can be easily shared.

Run application using script:

  1. Run mongodb database locally if not running, Open Git Bash in root directory of your project where Setup.sh file is present and run the below command:

    ./script.sh

  2. This will setup the frontend application and database, finally start the server using below command:

    cd server
npm start

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 the client directory using command "cd client" and create a .env.local file and copy contents of .env.sample file to .env.local file and add server URL.

  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!


Usage

To use the app, follow these steps:

  1. Enter a long URL in the input field and click the "Shorten" button.
  2. Copy the shortened URL and share it with others.

Featured In:

Open Source Programs

Event Logo Event Name Event Description
GSSoC 24 GirlScript Summer of Code 2024 GirlScript Summer of Code is a three-month-long Open Source Program conducted every summer by GirlScript Foundation. It is an initiative to bring more beginners to Open-Source Software Development.

Code of Conduct:

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.


License:

License
This project is licensed under the MIT License.

Don't forget to leave a star for this project!

Go to Top