URL Shortener

This is URL Shortener application ran by Appwrite cloud function., on Appwrite platform.
This project is part of Appwrites Lightning Hackathon.

Currently working demo: On this link

About

This project is a simple URL Shortener service.
It contains a form with URL and Alias inputs.

In URL input you add your URL you want shorten.
In Alias input you write something with what will you recognize what Short URL represents. It is only arbitrary.

It contains a button that can fetch your Short URLs from a database into the table on the same page.

Here is a project preview:

Services

This project contains services:

Automatic generation of backend resources, like database, collection and attributes once you visit / page in your browser.
- To manually create backend resources, refer to these 2 files:
- - Config
- - Backend resources utilities
Preview of generator form and your generated urls
Generation of short url record

Project Setup

Manual Setup

Fork this repository
Clone it locally
Change project ID inisde appwrite.json file to your project ID.
While in root folder, run appwrite cli command appwrite deploy function and follow steps to deploy it
- If you don't have appwrite cli installed, check this link and install it on your device
Once function is deployed, set environment variables to it:
- DOMAIN
- PROJECT_API_KEY

PROJECT-API-KEY is your api key from a project.
DOMAIN is your custom domain you want your function to run on. If you do not have custom domain registered and set, set your appwrite-gived domain for that function.
For example:

DOMAIN=624fbdf32f3aa04c42.appwrite.global
PROJECT_API_KEY=YOU API KEYWITH ALL PERMISSIONS

Development

This project is developed with:

Typescript
appwrite-node
HTML, CSS and JS for template

Refer to Package JSON file

How to start with development

Locally, go to functions/url-shortener path.
Run npm install command
Start coding

NOTE: Make code adjustments only inside dev folder. Code inside dev folder will be built into src folder.

How to deploy

While inside functions/url-shortener path, run nom run build command after you made your desired code changes
Go back to the root folder and run appwrite deploy function command. Follow the steps to deploy your function.
If needed, refer back to Manual Setup section

How to use

Routes

/ - Shows a static generator template and generated backend resources in the background if they do not exist.
/generate-short-url:
- Generates Short URL record
- Allows POST method only
- Must have 'Content-Type': 'application/json' header

Allowed payload example:

JSON.stringify({
alias: ALIAS VALUE,
url: URL VALUE
})

/my-short-urls - Gets your short url records
- It will return 100 at the time. if you have more than 100 records, you need to update code to show more.
- Allows only POST method
- Must have 'Content-Type': 'application/json' header
/delete-record:
- Deletes Short URL record
- Allows POST method only
- Must have 'Content-Type': 'application/json' header