akvaplan_fresh

Akvaplan-niva company website

• HTML-first multi-page web app
• Server-side rendered in Deno Deploy – fully functional without JavaScript
• Bilingual, including translated/SEO URLs

Tech stack

• Deno
• KV
• Fresh
• Orama
• TypeScript

Development

Start development server:

deno task dev

Intl

The app is server-rendered in one of two locales (en or no).

Locale detection

For requests to / the browser's list of accepted languages is used to pick locale (see _middleware.tsx).

Users are then redirected to either /en or /no and served the Home route.

// routes/home.tsx
export const config: RouteConfig = {
  routeOverride: "/:lang(en|no){/:page(home|hjem)}?",
};

All regular HTML-routes starts with a language segment, which is used to set the app's lang signal for use in translation.

Translations

In TSX, use the translation function t to lookup a text string in the present language.

import { t } from "akvaplan_fresh/text/mod.ts";
<p>{
  t(`some.prefix.some.key`);
}</p>

Translations are kept in a simple (key-value) JSON file for each locale.

KV

Connect to preview or production database, by setting env variables deno_kv_database and DENO_KV_ACCESS_TOKEN in .env:

deno_kv_database=https://api.deno.com/databases/$preview/connect
DENO_KV_ACCESS_TOKEN=

Export

$ ./bin/kv_list '[]' | nd-filter '!/^(avatar|mynewsdesk|session_user|site_sessions)/.test(d.key[0])' > data/kv_export/prod.ndjson

Permissions

Rights are set using a system, resource, email list, with permitted actions ("crud") like:

$ ./bin/kv_set '["rights","kv","panel","xyz@akvaplan.niva.no"]' '{"actions":"cru"}'

Panels

Export/seed

./bin/kv_list '["panel"]' |  nd-map d.value > data/seed/panels.ndjson
deno task kv-seed

User preferences

deno task kv_set '["@", "config", "nmi"]' '{"search":{"enabled":true,"exclude":["person","pubs"]},"cristin":{"enabled":true}}'