hi-kue/url-shortener-flpy

Url-Shortener website build with Flask, Jinja Templating, and TailwindCSS for UI.

Url-Shortener - A Simple Url Shortener Service

A simple url shortener service built with Flask, providing a RESTful API for shortening urls.

Report Bug ✱ Request Feature ✱ Documentation

Table of Contents

• About The Project
• Installation
• License
• Contributing
• Acknowledgements

About The Project

This project is a simple url shortener service built with Flask, providing a RESTful API for shortening urls. It was built as a learning guide for Flask and is referenced from a LinkedIn Learning course on Flask.

If you would like to know the course, please check the Acknowledgements section.

Installation

Installing the repository is as simple as cloning the repository and installing the dependencies; The following steps will guide you through the process.

1. Clone the repository

git clone https://github.com/Hi-kue/url-shortener-flpy.git

2. Change into the project directory

cd url-shortener-flpy

3. Create a virtual environment using pipenv (make sure to have it installed)

pipenv shell

4. Install the dependencies (pipenv)

pipenv install -r requirements.txt

5. Install the dependencies (npm)

npm install 

6. Start both the backend and frontend services (2 terminals)

# Terminal 1
npm run build

# Terminal 2
flask start

You should now have the application running on http://localhost:5000, or any other port you specified.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Please read the CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests. Any contributions you make are greatly appreciated.

Acknowledgements

This project was referenced from a LinkedIn Learning course covering the Flask framework. The course is titled Flask Essential Training by LinkedIn Learning.

Huge thanks to the author Nick Walter for the amazing course!