Go URL

A simple URL shortener written in Go with a React frontend and Postgres database.

Features

• Shorten urls based on a user defined key
• Alias a key to point to another short url
• Open multiple pages at once by separating keys with a comma
• Alias a key to point to multiple other keys
• Use variables in URLs
• Opensearch integration to provide suggestions directly to browser
• Frontend to view most popular searches and search to find existing links
• Frontend to allow anyone to add and edit links
• Optional authentication using Azure AD or Okta
• Slack / command integration
• Slackbot integration

Getting Started

The recommended way to test and deploy is using Docker. You will need to run both the go-url app, and the Postgres DB.

Start Postgres

docker run -d -P --name db -e POSTGRES_PASSWORD=password -e POSTGRES_DB=go -e POSTGRES_ADDR=db:5432 postgres:11.3-alpine

Start App

docker run -p 1323:1323 -e HOSTS=localhost -e APP_URI=http://localhost:1323 --link db alexbrazier/go-url

Alteratively use the docker-compose file and run:

docker-compose up

Development

Open http://localhost:8080/go

Run Postgres manually or with Docker

docker-compose up postgres

Install node (via nvm), yarn & go

brew install nvm yarn go
nvm install

Start frontend

cd frontend
yarn
yarn start

Start API

cd api
dep ensure
POSTGRES_PASS=password HOSTS=localhost APP_URI=http://localhost:3000 go run server.go

Enviroment Configuration

FAQ

Slackbot is posting multiple replies messages to a single message

When enabled, the Slackbot will be running on every node in a load balanced system. Either disable load balancing, or run a separate instance just for the Slackbot.