EDJX Platform Example App (EdjURL)

This is an example application that demonstrates the features of the EDJX platform.

App Description

This app implements a simple URL shortener.

The app consists of these components:

• URL shortening function
  • Source code: rust_url_shorten (Rust)
  • Takes a URL and generates a short string
  • The URL is passed to the function in a url query parameter
• URL fetch function
  • Source code: rust_url_fetch (Rust) or cpp_url_fetch (C++)
  • Given a short string, it redirects to the full URL
  • The short string is passed to the function in an s query parameter
• HTML page
  • Source code: html (HTML, CSS, JavaScript)
  • Provides a user interface for the functions

How to Deploy the App

1. Build and deploy the application code:
   1. Create a new edjurl application in the EDJX Console.
   2. Build the rust_url_shorten code to get a urlshorten.wasm file.
   3. Create a new shorten function inside the edjurl application in the EDJX Console, select the urlshorten.wasm file.
   4. Build the rust_url_fetch (or cpp_url_fetch) code to get a urlfetch.wasm file.
   5. Create a new fetch function inside the edjurl application in the EDJX Console, select the urlfetch.wasm file.
2. Deploy the HTML page:
   1. In the html/scripts.js file, change
      • the APP_URL variable to the URL of the deployed shorten function (it will be used by JavaScript),
      • the FETCH_PREFIX variable to the URL of the deployed fetch function followed by the ?s= query string (it will be displayed to the user).
   2. Create a new edjurl bucket in the EDJX Console.
   3. Upload all files from the html folder to the new edjurl bucket.
   4. In the EDJX Console, set the Content-Disposition header to the value inline for the index.html file so that accessing the file URL in a web browser displays the HTML page instead of downloading it as a file.
3. Add a domain (optional):
   1. If you own a domain (e.g., example.org), you can add the domain to the EDJX Console.
   2. Add an SSL/TLS certificate in the domain settings in the EDJX Console in order to enable HTTPS traffic.
   3. You can set Request Routing rules in the EDJX Console so that (in this order):
      • example.org/?s=* (pattern match) redirects to https://[AppID].fn.edjx.net/fetch?{query}
      • example.org (exact match) redirects to the HTML page in the bucket https://[BucketID].storage.edjx.net/blobs/index.html
   4. If the domain is set up correctly, visiting https://example.org in a web browser will display the EdjURL home page. A shortened URL will look like this: https://example.org/?s=SHORTSTRING.