Code Monkey home page Code Monkey logo

ziplink's Introduction

Short URL Generator

Description

This application empowers users to generate short, personalized URLs using Nest.js.

Getting Started

Follow these instructions to set up the project on your local machine for development and testing purposes.

  • Clone the repository to your local machine: git clone https://github.com/andreacw5/short-url-generator.git
  • Install dependencies: yarn install
  • Start the application: yarn start:dev
  • Visit http://localhost:3000 in your browser to use the application.

Features

  • Create short URLs
  • Edit short URLs
  • Delete short URLs
  • Redirect to the default URL if the code is not found
  • Click recording for short URLs
  • Dockerized application
  • GitHub actions for build
  • API Auth token for create, update, and delete endpoints
  • Swagger documentation

Next planned functionality

  • More detailed statistics for short urls
  • Testing with Jest
  • Deployment with frontend management page

Built With

  • Nest.js - A progressive Node.js framework for building efficient, reliable and scalable server-side applications.
  • TypeORM - ORM for TypeScript and JavaScript (ES7, ES6, ES5).

Requirements

Authentication for management

Authentication is based on a single static token stored in the API_KEY environment variable. Requests for create/edit/delete URLs require the X-API-KEY header with the value of API_KEY.

Environment Variables

code description default value
DATABASE_HOST database url localhost
DATABASE_PORT database port number 5432
DATABASE_NAME database name url-manager
DATABASE_USERNAME database username postgres
DATABASE_PASSWORD database password
DEFAULT_REDIRECT_URL default redirect if code is not found https://google.com
DEFAULT_URL_CODE default code for redirect for click recording code
API_KEY auth token for CUD Endpoints 2342358

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Author

License

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

ziplink's People

Contributors

andreacw5 avatar dependabot[bot] avatar

Watchers

 avatar Kostas Georgiou avatar

ziplink's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.