Instantly generate shortened links online with custom aliases.

• Highly performant and optimized
• Users can create custom aliases for links
• Responsive user interface
• Supports sharing via native share sheet
• Supports HTTPS

1. Clone the project: git clone https://github.com/xtt28/shortener
2. Switch to the project directory: cd shortener
3. Create your .env file (see the Environment Variables section)
4. Start the server: go run .
5. Go to http://localhost:8080 in your web browser

To run tests, run the following command:

  go test ./...

To run this project, you will need to add the following environment variables to your .env file:

ROOT - the URL to your instance

PORT - the port to run your instance on

The following environment variables concern TLS:

TLS_ENABLED - whether to enable TLS

TLS_CERT - the path to the TLS certificate file

TLS_KEY - the path to the TLS key file

Please refer to the template.env file for an example.

  POST /api/create

  GET /v/${id}

Client: Bootstrap, htmx

Server: Go, Gin, GORM, SQLite

Contributions are always welcome. Please:

1. write tests for your code;
2. run it through go fmt and go vet.

MIT