Aksel

Innhold

Repoet inneholder all kode for cms og nettside til aksel.nav.no

/Website

Nextjs applikasjon som henter data fra et sanity-datasett.

Siden leverer akkurat nå to løsninger:

Innhold på topnivå i Aksel, eks artikler, prinsipper og blogger
Designsystem-dokumentasjon under https://aksel.nav.no/designsystem

Begge løsningene gjenbruker for det meste de samme modulene under website/components, med litt diverse styling-justeringer mellom dem.

/sanity

sanity.io studioet sin kode er forvaltet her. Det publiserte studioet finner man på aksel.nav.no/studio.

production-datasettet er privat da løsningen etterhvert skal tilby innloggede sider, så man må ha riktige tilganger for å kunne lese/jobbe med dataen der. schemas for datasettet finnes under sanity/schemas, mens de fleste tilpassninger av selve studioet finnes under sanity/client

Kom i gang

Bidrag

Branch main blir pusher rett til prod og da aksel.nav.no. For å utvikle nye features brukes branch NEXT som ved push publiseres til devmiljø aksel.dev.nav.no (krever naisdevice).

Nettside (localhost:3000)

yarn install
yarn dev

For å se preview innhold kan man legge til preview i URL-en´. Eks:

`/preview/designsystem/side/button´

NOTE: Sanity-datasettet er privat, noe som betyr du må ha følgende token for å få data lokalt:

SANITY_PRIVATE_NO_DRAFTS

Sanity (localhost:3333)

Note: Må være developer i https://verktoykasse.sanity.studio, Ta kontakt med Ken A. Johansen nevnt under "Henvendelser" om det trengs.

Starter opp sanity-studioet lokalt. Husk at alle endringer i datasettet lokalt også gjøres i prod. Bytt derfor til development-dataset hvis man vil teste destruktive handlinger.

yarn install
yarn sanity

.env

Blir brukt flere keys i .env under ./website, men kun SANITY_PRIVATE_NO_DRAFTS trengs for å teste lokalt

SANITY_WRITE_KEY: Secret for å sende dokumenter til sanity, brukt til å oppdatere sanboxes/examples/farger
ALGOLIA_ADMIN: Secret for å oppdatere records i søkemotoren. Gjøres automatisk i prod ved hjelp av Sanity-webhook hver gang et dokument endres. Trengs bare hvis man oppdaterer søkeindexen lokalt
ALGOLIA_ID: Søkemotor algolia-index-id for å redigere riktig Index. ---||---
TRELLO_TOKEN: Sender feedback til et egent trello-board. Ikke nødvendig lokalt hvis man ikke vil teste feedback-modulen.
SENTRY_AUTH_TOKEN: Gir appen tilgang til Sentry-logging (er for tiden disabled, så ikke nødvendig lokalt)
SANITY_PREVIEW_TOKEN: Gir appen tilgang til å lese draft innhold fra sanity i "preview"-mode
SANITY_PRIVATE_NO_DRAFTS: Gir appen tilgang til å lese innhold fra Sanity da datasettet er privat

Søk

Søk-index blir generert av algolia-scraper. Kjøres daglig i en github-action, men kan kjøres lokalt også med docker.

docker run -it --env-file=.env -e "CONFIG=$(cat crawler.json | jq -r tostring)" algolia/docsearch-scraper

Backups

Kjøres daglige backups av hele sanity-datasettet til GCP-bucket under designsystem-prod

Henvendelser

Tar gjerne imot issues! Spørsmål og kontakt ang kode kan rettes til Ken A. Johansen på slack eller mail: ken.aleksander.johansen@nav.no.

Aksel har også en egen slack-kanal #Aksel der vi tar imot henvendelser!

DopamineDriven/aksel-website