Skip to content

dafonso/url-shortener

Repository files navigation


Logo

A simple, open-source URL shortener app.

· Report Bug · Request Feature

Table of Contents

About The Project

  • Create a shortened link for a target URL
  • Access stats of that link

URL Shortener screenshot

Built With

Getting Started

To get a local copy up and running follow these simple steps.

Requirements

This is an example of how to list things you need to use the software and how to install them.

  • PHP >= 7.2.5
    • BCMath PHP Extension
    • Ctype PHP Extension
    • Fileinfo PHP extension
    • JSON PHP Extension
    • Mbstring PHP Extension
    • OpenSSL PHP Extension
    • PDO PHP Extension
    • Tokenizer PHP Extension
    • XML PHP Extension
    • SQLite PHP Extension
  • Composer
  • npm

Installation

  1. Clone url-shortener repo
git clone https://github.com/dafonso/url-shortener.git && cd url-shortener
  1. Install dependencies
npm install && composer install
  1. Copy .env.example file
cp .env.example .env
  1. Create SQLite file
touch database/database.sqlite
  1. Generate a new encryption key for the app
php artisan migrate:fresh
  1. Run Migrations
php artisan migrate:fresh
  1. Run Mix and Serve app
npm run prod && php artisan serve
  1. Access URL Shortener app on http://localhost:8000

Testing

php artisan test

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Diogo Afonso - @dafonso

Project Link: https://github.com/dafonso/url-shortener

Acknowledgements