feat: custom error page (#178)

Co-authored-by: Daniel Roe <daniel@roe.dev>

app.vue

@@ -1,21 +1,8 @@
 <script setup>
-import { APP_NAME } from './constants'
+usePageHeader()
-
-const isDev = process.dev
-const isPreview = window.location.hostname.includes('deploy-preview')
-
-useHead({
-  titleTemplate: title => `${title ? `${title} | ` : ''}${APP_NAME}${isDev ? ' (dev)' : isPreview ? ' (preview)' : ''}`,
-  link: [
-    { rel: 'icon', type: 'image/svg+png', href: isDev || isPreview ? '/favicon-dev.png' : '/favicon.png' },
-  ],
-})
 
 // We want to trigger rerendering the page when account changes
 const key = computed(() => useMasto().instances.config.url || 'default')
-
-// eslint-disable-next-line no-unused-expressions
-isDark.value
 </script>
 
 <template>
@@ -27,19 +14,3 @@ isDark.value
     id="teleport-end"
   />
 </template>
-
-<style>
-html, body , #__nuxt{
-  height: 100vh;
-  margin: 0;
-  padding: 0;
-}
-
-html.dark {
-  color-scheme: dark;
-}
-
-html {
-  --at-apply: bg-base text-base;
-}
-</style>

composables/page-header.ts

@@ -0,0 +1,16 @@
+import { APP_NAME } from '~/constants'
+
+const isDev = process.dev
+const isPreview = window.location.hostname.includes('deploy-preview')
+
+export function usePageHeader() {
+  useHead({
+    titleTemplate: title => `${title ? `${title} | ` : ''}${APP_NAME}${isDev ? ' (dev)' : isPreview ? ' (preview)' : ''}`,
+    link: [
+      { rel: 'icon', type: 'image/svg+png', href: isDev || isPreview ? '/favicon-dev.png' : '/favicon.png' },
+    ],
+  })
+
+  // eslint-disable-next-line no-unused-expressions
+  isDark.value
+}

error.vue

@@ -0,0 +1,57 @@
+<script setup lang="ts">
+import type { NuxtError } from '#app'
+
+// prevent reactive update when clearing error
+const { error } = defineProps<{
+  error: Partial<NuxtError>
+}>()
+
+usePageHeader()
+
+// add more custom status codes messages here
+const errorCodes: Record<number, string> = {
+  404: 'Page not found',
+}
+
+const defaultMessage = 'Something went wrong'
+
+const message = error.message ?? errorCodes[error.statusCode!] ?? defaultMessage
+
+const state = ref<'error' | 'reloading'>('error')
+const reload = async () => {
+  state.value = 'reloading'
+  try {
+    if (!useMasto())
+      await loginTo(currentUser.value)
+    clearError({ redirect: currentUser.value ? '/home' : '/public' })
+  }
+  catch {
+    state.value = 'error'
+  }
+}
+</script>
+
+<template>
+  <NuxtLoadingIndicator color="repeating-linear-gradient(to right,var(--c-primary) 0%,var(--c-primary-active) 100%)" />
+  <NuxtLayout>
+    <MainContent>
+      <template #title>
+        <span text-lg font-bold>Error</span>
+      </template>
+      <slot>
+        <form p5 grid gap-y-4 @submit="reload">
+          <div text-lg>
+            Something went wrong
+          </div>
+          <div text-secondary>
+            {{ message }}
+          </div>
+          <button flex items-center gap-2 justify-center btn-solid text-center :disabled="state === 'reloading'">
+            <span v-if="state === 'reloading'" i-ri:loader-2-fill animate-spin inline-block />
+            {{ state === 'reloading' ? 'Reloading' : 'Reload' }}
+          </button>
+        </form>
+      </slot>
+    </MainContent>
+  </NuxtLayout>
+</template>

nuxt.config.ts

@@ -55,6 +55,12 @@ export default defineNuxtConfig({
       translateApi: '',
     },
   },
+  nitro: {
+    prerender: {
+      crawlLinks: false,
+      routes: ['/200.html'],
+    },
+  },
   app: {
     keepalive: true,
   },

plugins/masto.ts

@@ -2,6 +2,7 @@ import type { MastoClient } from 'masto'
 import { currentUser } from '../composables/users'
 
 export default defineNuxtPlugin(async () => {
+  let masto!: MastoClient
   try {
     const { query } = useRoute()
     const user = typeof query.server === 'string' && typeof query.token === 'string'
@@ -9,7 +10,15 @@ export default defineNuxtPlugin(async () => {
       : currentUser.value
 
     // TODO: improve upstream to make this synchronous (delayed auth)
-    const masto = await loginTo(user) as MastoClient
+    masto = await loginTo(user)
+  }
+  catch {
+    // Show error page when Mastodon server is down
+    showError({
+      fatal: true,
+      statusMessage: 'Could not log into account.',
+    })
+  }
 
   return {
     provide: {
@@ -19,13 +28,4 @@ export default defineNuxtPlugin(async () => {
       }),
     },
   }
-  }
-  catch {
-    // TODO: handle error
-    // Show error page when Mastodon server is down
-    throw createError({
-      fatal: true,
-      statusMessage: 'Could not log into account.',
-    })
-  }
 })

styles/global.css

@@ -103,3 +103,17 @@ html {
     background-position: 0 50%
   }
 }
+
+html, body , #__nuxt{
+  height: 100vh;
+  margin: 0;
+  padding: 0;
+}
+
+html.dark {
+  color-scheme: dark;
+}
+
+html {
+  --at-apply: bg-base text-base;
+}