feat: decodeEmail XOR function

* feat: client-side katex.js

* docs: add katex attribution

.github/workflows/docker-image.yml

@@ -0,0 +1,47 @@
+name: Create and publish a Docker image
+
+# Configures this workflow to run every time a change is pushed to the branch called `release`.
+on:
+    push:
+        branches: ['release']
+
+# Defines two custom environment variables for the workflow. These are used for the Container registry domain, and a name for the Docker image that this workflow builds.
+env:
+    REGISTRY: ghcr.io
+    IMAGE_NAME: ${{ github.repository }}
+
+# There is a single job in this workflow. It's configured to run on the latest available version of Ubuntu.
+jobs:
+    build-and-push-image:
+        runs-on: ubuntu-latest
+        # Sets the permissions granted to the `GITHUB_TOKEN` for the actions in this job.
+        permissions:
+            contents: read
+            packages: write
+            #
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v4
+            # Uses the `docker/login-action` action to log in to the Container registry registry using the account and password that will publish the packages. Once published, the packages are scoped to the account defined here.
+            - name: Log in to the Container registry
+              uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1
+              with:
+                  registry: ${{ env.REGISTRY }}
+                  username: ${{ github.actor }}
+                  password: ${{ secrets.GITHUB_TOKEN }}
+            # This step uses [docker/metadata-action](https://github.com/docker/metadata-action#about) to extract tags and labels that will be applied to the specified image. The `id` "meta" allows the output of this step to be referenced in a subsequent step. The `images` value provides the base name for the tags and labels.
+            - name: Extract metadata (tags, labels) for Docker
+              id: meta
+              uses: docker/metadata-action@9ec57ed1fcdbf14dcef7dfbe97b2010124a938b7
+              with:
+                  images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+            # This step uses the `docker/build-push-action` action to build the image, based on your repository's `Dockerfile`. If the build succeeds, it pushes the image to GitHub Packages.
+            # It uses the `context` parameter to define the build's context as the set of files located in the specified path. For more information, see "[Usage](https://github.com/docker/build-push-action#usage)" in the README of the `docker/build-push-action` repository.
+            # It uses the `tags` and `labels` parameters to tag and label the image with the output from the "meta" step.
+            - name: Build and push Docker image
+              uses: docker/build-push-action@f2a1d5e99d037542a71f64918e516c093c6f3fc4
+              with:
+                  context: .
+                  push: true
+                  tags: ${{ steps.meta.outputs.tags }}
+                  labels: ${{ steps.meta.outputs.labels }}

README.md

@@ -14,26 +14,29 @@ This project is super lightweight by design. The UI is simple and the frontend i
 
 ## Clearnet Instances
 
-| Instance URL                                                                    | Region                          | Notes                                                                                            |
-| ------------------------------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------ |
-| [code.whatever.social](https://code.whatever.social)                            | United States & The Netherlands | Operated by [Whatever Social](https://whatever.social) and [http.james](https://httpjames.space) |
-| [ao.vern.cc](https://ao.vern.cc)                                                | United States                   | Operated by [vern.cc](https://vern.cc)                                                           |
-| [overflow.smnz.de](https://overflow.smnz.de)                                    | Germany                         | Operated by [smnz.de](https://smnz.de)                                                           |
-| [overflow.lunar.icu](https://overflow.lunar.icu)                                | Germany                         | Operated by [lunar.icu](https://lunar.icu/)                                                      |
-| [overflow.adminforge.de](https://overflow.adminforge.de/)                       | Germany                         | Operated by [adminForge](https://adminforge.de/)                                                 |
-| [overflow.hostux.net](https://overflow.hostux.net/)                             | France                          | Operated by [Hostux](https://hostux.net/)                                                        |
-| [overflow.projectsegfau.lt](https://overflow.projectsegfau.lt/)                 | United States, France, India    | Operated by [Project Segfault](https://projectsegfau.lt/)                                        |
-| [code.xbdm.fun](https://code.xbdm.fun)                                          | Germany                         | Operated by [xbdm.fun](https://xbdm.fun)                                                         |
-| [overflow.fascinated.cc](https://overflow.fascinated.cc/)                       | Germany                         | Operated by [fascinated.cc](https://fascinated.cc/)                                              |
-| [ao.bloatcat.tk](https://ao.bloatcat.tk)                                        | Iceland                         | Operated by [bloatcat.tk](https://bloatcat.tk)                                                   |
-| [anonoverflow.frontendfriendly.xyz](https://anonoverflow.frontendfriendly.xyz/) | United States                   | Operated by [frontendfriendly.xyz](https://frontendfriendly.xyz/)                                |
-| [ao.owo.si](https://ao.owo.si/)                                                 | Germany                         | Operated by [owo.si](https://owo.si/)                                                            |
-| [overflow.datura.network](https://overflow.datura.network/)                     | Germany                         | Operated by [datura.network](https://datura.network)                                             |
-| [overflow.freedit.eu](overflow.freedit.eu)                                      | United States                   | Operated by [freedit.eu](https://freedit.eu)                                                     |
-| [ao.ftw.lol](https://ao.ftw.lol)                                                | Germany                         | Operated by [ftw.lol](https://ftw.lol)                                                           |
-| [anonoverflow.hyperreal.coffee](https://anonoverflow.hyperreal.coffee)          | United States                   | Operated by [hyperreal.coffee](https://hyperreal.coffee)                                         |
-| [a.opnxng.com](a.opnxng.com)                                                    | Singapore                       | Operated by [opnxng.com](https://about.opnxng.com)                                               |
-| [overflow.sudovanilla.com](https://overflow.sudovanilla.com)                    | United States                   | Operated by [SudoVanilla](https://sudovanilla.com)                                               |
+| Instance URL                                                                              | Region                          | Notes                                                                                            |
+| ----------------------------------------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------ |
+| [code.whatever.social](https://code.whatever.social)                                      | United States & The Netherlands | Operated by [Whatever Social](https://whatever.social) and [http.james](https://httpjames.space) |
+| [ao.vern.cc](https://ao.vern.cc)                                                          | United States                   | Operated by [vern.cc](https://vern.cc)                                                           |
+| [overflow.smnz.de](https://overflow.smnz.de)                                              | Germany                         | Operated by [smnz.de](https://smnz.de)                                                           |
+| [overflow.lunar.icu](https://overflow.lunar.icu)                                          | Germany                         | Operated by [lunar.icu](https://lunar.icu/)                                                      |
+| [overflow.adminforge.de](https://overflow.adminforge.de/)                                 | Germany                         | Operated by [adminForge](https://adminforge.de/)                                                 |
+| [overflow.hostux.net](https://overflow.hostux.net/)                                       | France                          | Operated by [Hostux](https://hostux.net/)                                                        |
+| [overflow.projectsegfau.lt](https://overflow.projectsegfau.lt/)                           | United States, France, India    | Operated by [Project Segfault](https://projectsegfau.lt/)                                        |
+| [code.xbdm.fun](https://code.xbdm.fun)                                                    | Germany                         | Operated by [xbdm.fun](https://xbdm.fun)                                                         |
+| [overflow.fascinated.cc](https://overflow.fascinated.cc/)                                 | Germany                         | Operated by [fascinated.cc](https://fascinated.cc/)                                              |
+| [ao.bloatcat.tk](https://ao.bloatcat.tk)                                                  | Iceland                         | Operated by [bloatcat.tk](https://bloatcat.tk)                                                   |
+| [anonoverflow.frontendfriendly.xyz](https://anonoverflow.frontendfriendly.xyz/)           | United States                   | Operated by [frontendfriendly.xyz](https://frontendfriendly.xyz/)                                |
+| [ao.owo.si](https://ao.owo.si/)                                                           | Germany                         | Operated by [owo.si](https://owo.si/)                                                            |
+| [overflow.datura.network](https://overflow.datura.network/)                               | Germany                         | Operated by [datura.network](https://datura.network)                                             |
+| [overflow.freedit.eu](overflow.freedit.eu)                                                | United States                   | Operated by [freedit.eu](https://freedit.eu)                                                     |
+| [ao.ftw.lol](https://ao.ftw.lol)                                                          | Germany                         | Operated by [ftw.lol](https://ftw.lol)                                                           |
+| [anonoverflow.hyperreal.coffee](https://anonoverflow.hyperreal.coffee)                    | United States                   | Operated by [hyperreal.coffee](https://hyperreal.coffee)                                         |
+| [a.opnxng.com](a.opnxng.com)                                                              | Singapore                       | Operated by [opnxng.com](https://about.opnxng.com)                                               |
+| [overflow.sudovanilla.com](https://overflow.sudovanilla.com)                              | United States                   | Operated by [SudoVanilla](https://sudovanilla.com)                                               |
+| [anonymousoverflow.privacyfucking.rocks](https://anonymousoverflow.privacyfucking.rocks/) | Germany                         | Operated by [privacyfucking.rocks](https://privacyfucking.rocks)                                 |
+| [exchange.seitan-ayoub.lol](https://exchange.seitan-ayoub.lol)                            | Germany                         | Operated by [Seitan Ayoub](https://seitan-ayoub.lol)                                             |
+| [overflow.r4fo.com](https://overflow.r4fo.com)                                            | The Netherlands                 | Operated by [r4fo.com](https://r4fo.com)                                                         |
 
 ## Other Instances
 

config/version.go

@@ -1,3 +1,3 @@
 package config
 
-var Version = "1.9.0"
+var Version = "1.10.1"

docker-compose.example.yml

@@ -1,14 +1,12 @@
 version: '3'
 
 services:
-  anonymousoverflow:
-    container_name: 'app'
-    build:
-      context: .
-      network: 'host'
-    environment:
-      - APP_URL=https://domain.com
-      - JWT_SIGNING_SECRET=secret
-    ports:
-      - '80:8080'
-    restart: 'always'
+    anonymousoverflow:
+        container_name: 'app'
+        image: 'ghcr.io/httpjamesm/anonymousoverflow:release'
+        environment:
+            - APP_URL=https://domain.com
+            - JWT_SIGNING_SECRET=secret
+        ports:
+            - '80:8080'
+        restart: 'always'

main.go

@@ -51,6 +51,7 @@ func main() {
 	r.POST("/", routes.PostHome)
 
 	r.GET("/a/:id", routes.RedirectShortenedOverflowURL)
+	r.GET("/q/:id", routes.RedirectShortenedOverflowURL)
 
 	r.GET("/questions/:id", func(c *gin.Context) {
 		// redirect user to the question with the title

src/middleware/options.go

@@ -1,6 +1,8 @@
 package middleware
 
-import "github.com/gin-gonic/gin"
+import (
+	"github.com/gin-gonic/gin"
+)
 
 func OptionsMiddleware() gin.HandlerFunc {
 	return func(c *gin.Context) {
@@ -8,23 +10,17 @@ func OptionsMiddleware() gin.HandlerFunc {
 		c.Set("theme", "dark")
 
 		imagesCookie, err := c.Cookie("disable_images")
-		if err != nil {
-			c.Next()
-			return
-		}
-
-		if imagesCookie == "true" {
-			c.Set("disable_images", true)
+		if err == nil {
+			if imagesCookie == "true" {
+				c.Set("disable_images", true)
+			}
 		}
 
 		themeCookie, err := c.Cookie("theme")
-		if err != nil {
-			c.Next()
-			return
-		}
-
-		if themeCookie == "light" {
-			c.Set("theme", "light")
+		if err == nil {
+			if themeCookie == "light" {
+				c.Set("theme", "light")
+			}
 		}
 
 		c.Next()

src/routes/home.go

@@ -40,7 +40,7 @@ func PostHome(c *gin.Context) {
 
 	// validate URL
 	isStackOverflow := strings.HasPrefix(soLink, "https://stackoverflow.com/questions/")
-	isShortenedStackOverflow := strings.HasPrefix(soLink, "https://stackoverflow.com/a/")
+	isShortenedStackOverflow := strings.HasPrefix(soLink, "https://stackoverflow.com/a/") || strings.HasPrefix(soLink, "https://stackoverflow.com/q/")
 	isStackExchange := stackExchangeRegex.MatchString(soLink)
 	if !isStackExchange && !isStackOverflow && !isShortenedStackOverflow {
 		c.HTML(400, "home.html", gin.H{

src/routes/options.go

@@ -30,12 +30,10 @@ func ChangeOptions(c *gin.Context) {
 		if c.MustGet("theme").(string) == "dark" {
 			text = "light"
 		}
+
 		c.SetCookie("theme", text, 60*60*24*365*10, "/", "", false, true)
 		// get redirect url from query
 		redirectUrl := c.Query("redirect_url")
-		if redirectUrl == "" {
-			redirectUrl = os.Getenv("APP_URL")
-		}
 
 		if !strings.HasPrefix(redirectUrl, os.Getenv("APP_URL")) {
 			redirectUrl = os.Getenv("APP_URL")

src/utils/cf.go

@@ -0,0 +1,56 @@
+package utils
+
+import (
+	"encoding/hex"
+	"net/url"
+	"strings"
+)
+
+// decodeEmail decodes an obfuscated email string.
+func DecodeEmail(encoded string) (string, error) {
+	// remove the prefix if present
+	prefix := "/cdn-cgi/l/email-protection#"
+	encoded = strings.TrimPrefix(encoded, prefix)
+
+	// get the key for XOR operation
+	key, err := hex.DecodeString(encoded[:2])
+	if err != nil {
+		return "", err
+	}
+
+	// decode the rest of the string using the key
+	var decodedChars []byte
+	// start a loop from the third character of the encoded string (index 2), as the first two characters are used as the key for XOR operation.
+	// the loop increments by 2 in each iteration because the encoded string is in hexadecimal format, and each hexadecimal character represents 4 bits.
+	// so, two hexadecimal characters represent one byte (8 bits), which is the size of a character in ASCII.
+	for i := 2; i < len(encoded); i += 2 {
+		// get the current pair of hexadecimal characters from the encoded string.
+		encodedPair := encoded[i : i+2]
+
+		// decode the hexadecimal pair to get the original byte. this is done by converting the hexadecimal pair to a byte using the DecodeString function from the encoding/hex package.
+		// if the hexadecimal pair is not a valid hexadecimal number, DecodeString will return an error.
+		pairBytes, err := hex.DecodeString(encodedPair)
+		if err != nil {
+			// if there is an error in decoding, return the error and an empty string.
+			return "", err
+		}
+
+		// perform an XOR operation on the decoded byte with the key. this is the reverse operation of the original encoding process.
+		// the XOR operation is a bitwise operation that returns 0 if the two bits are the same, and 1 otherwise.
+		// by performing the XOR operation with the same key used in the encoding process, we can retrieve the original byte.
+		decodedChar := pairBytes[0] ^ key[0]
+
+		// append the decoded character to the decodedChars slice. this slice will hold all the decoded characters of the encoded string.
+		decodedChars = append(decodedChars, decodedChar)
+	}
+	// convert the decoded bytes to a string
+	decoded := string(decodedChars)
+
+	// unescape any URL-encoded characters
+	unescaped, err := url.QueryUnescape(decoded)
+	if err != nil {
+		return "", err
+	}
+
+	return unescaped, nil
+}

templates/home.html

@@ -7,7 +7,7 @@
             http-equiv="Content-Security-Policy"
             content="default-src 'none'; style-src 'self'; script-src 'none'; img-src 'self';"
         />
-        <link rel="icon" href="/static/codecircles.png" />
+        <link rel="icon" href="/static/codecircles.webp" />
         <meta
             name="description"
             content="View StackOverflow threads in privacy and without the clutter."
@@ -19,7 +19,7 @@
             <div class="title">
                 <img
                     class="logo"
-                    src="/static/codecircles.png"
+                    src="/static/codecircles.webp"
                     alt="4 circles with alternating colors between green and white"
                 />
                 <h1>AnonymousOverflow</h1>

templates/question.html

@@ -26,7 +26,7 @@
                 <a href="/" class="logo-link">
                     <img
                         class="logo"
-                        src="/static/codecircles.png"
+                        src="/static/codecircles.webp"
                         alt="4 circles with alternating colors between green and white"
                     />
                 </a>

templates/sharedHead.html

@@ -1,4 +1,4 @@
 <meta name="theme-color" content="#8CFFC1" />
-<meta name="og:image" content="/static/codecircles.png" />
+<meta name="og:image" content="/static/codecircles.webp" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="stylesheet" href="/static/globals.css" />