Skip to content

devloperds/url-shortener

Repository files navigation

URL-SHORTENER


Table of Contents


Project Structure

└── url-shortener/
    ├── README.md
    ├── components.json
    ├── index.html
    ├── jsconfig.json
    ├── package-lock.json
    ├── package.json
    ├── postcss.config.js
    ├── public
    │   ├── a-man-celebrating-in-front-of-his-laptop-after-he--4d6ZDLiwQXOoZMFB4c6wrg-VXDhoEI-QjWFcfUQG8eG0g.jpeg
    │   ├── banner.jpeg
    │   ├── banner1.jpg
    │   ├── banner2.jpg
    │   ├── logo.jpeg
    │   ├── logo.png
    │   ├── qr.png
    │   └── vite.svg
    ├── src
    │   ├── App.css
    │   ├── App.jsx
    │   ├── components
    │   ├── context.jsx
    │   ├── db
    │   ├── hooks
    │   ├── index.css
    │   ├── layouts
    │   ├── lib
    │   ├── main.jsx
    │   └── pages
    ├── tailwind.config.js
    ├── vite.config.js
    └── yarn.lock

Getting Started

Prerequisites

Before getting started with url-shortener, ensure your runtime environment meets the following requirements:

  • Programming Language: JavaScript
  • Package Manager: Yarn, Npm

Installation

Install url-shortener using one of the following methods:

Build from source:

  1. Clone the url-shortener repository:
❯ git clone https://github.com/devloperds/url-shortener
  1. Navigate to the project directory:
cd url-shortener
  1. Install the project dependencies:

Using yarn  

❯ yarn install

Using npm  

❯ npm install

Usage

Run url-shortener using the following command: Using yarn  

❯ yarn run dev

Using npm  

❯ npm run dev

Testing

Run the test suite using the following command: Using yarn  

❯ yarn test

Using npm  

❯ npm test

Contributing

Contributing Guidelines
  1. Fork the Repository: Start by forking the project repository to your github account.
  2. Clone Locally: Clone the forked repository to your local machine using a git client.
    git clone https://github.com/devloperds/url-shortener
  3. Create a New Branch: Always work on a new branch, giving it a descriptive name.
    git checkout -b new-feature-x
  4. Make Your Changes: Develop and test your changes locally.
  5. Commit Your Changes: Commit with a clear message describing your updates.
    git commit -m 'Implemented new feature x.'
  6. Push to github: Push the changes to your forked repository.
    git push origin new-feature-x
  7. Submit a Pull Request: Create a PR against the original project repository. Clearly describe the changes and their motivations.
  8. Review: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your contribution!
Contributor Graph


License

This project is protected under the SELECT-A-LICENSE License. For more details, refer to the LICENSE file.


Acknowledgments

  • List any resources, contributors, inspiration, etc. here.

About

A full-stack URL shortener featuring user authentication, custom links, QR code generation, and real-time analytics(geographic locations).

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors