fp-frontend

Monorepo for Frontend kode for foreldrepenger.

Storybook

https://navikt.github.io/fp-frontend

For å komme i gang

Lag en .yarnrc.yml-fil i hjemmefolderen din: (Bytt ut med ditt genererte token)

npmRegistries:
  https://npm.pkg.github.com:
    npmAlwaysAuth: true
    npmAuthToken: <token>

Kjør så desse kommandoene for å installere og bygge applikasjonen:

yarn install
yarn build

En kan kjøre tester og linting både fra rot og fra de ulike pakkene:

yarn test
yarn tsc
yarn eslint
yarn stylelint

Utvikling

1. Vite Mode

Vi har en utviklingsmetode vi kaller for "Vite mode". Den gjør at du kan bruke server som er deployet (eller i autotest) som utgangspunkt. Fordelen er at du får brukt helt "ekte" dev data, men med frontend servert fra din localhost.

1. cd til appen cd apps/fp-frontend-app
2. Kjør yarn dev. Nå har du lokal vite-server kjørende på localhost:9010
3. Gå til ingress i dev (https://fpsak.intern.dev.nav.no/) eller autotest (http://localhost:9000/)
4. Aktiver Vite-mode:

• Legg til /vite-on i slutten av URL-en du bruker i nettleseren (fra steg 3)
• Dette setter en cookie kalt use-local-vite-server i nettleseren din
• Cookien instruerer den deployede serveren til å sende deg en spesiell index.html
• Denne HTML-filen laster JavaScript fra din lokale utviklingsserver.
• Du vil nå se endringer du gjør lokalt mens du bruker den deployede backend-en

2. Storybook

For å kjøre opp storybook. Gå inn i aktuell pakke og kjør:

yarn storybook

Utvikling mot lokal kode i ft-frontend-saksbehandling

cd fp-frontend
yarn link <sti til folder på disk>
Eksempel: yarn link ../../../ft-frontend-saksbehandling/packages/sak-fagsak-profil/

cd ft-frontend-saksbehandling
Gå til aktuell pakke og kjør yarn dev

yarn link endrer på package.json og lock-filen, så husk å kjør unlink før commit/push

For å gå tilbake til å bruke publisert pakke:

cd fp-frontend
yarn unlink <sti til folder på disk>
Eksempel: yarn unlink ../../../ft-frontend-saksbehandling/packages/sak-fagsak-profil/

Utvikle lokalt med autotest

For å utvikle lokalt på fpfrontend mot autotest må man kjøre opp autotest (f.eks. kjøre ./lokal-utvikling/lokal-utvikling-ide.sh i fp-autotest-repoet). Her er det viktig å understreke at fpfrontend(:9090) også skal spinnes opp i autotest. Det er fordi man trenger fpfrontend i docker til å få til login. Deretter kan man starte fpfrontend lokalt på http://localhost:9010 med yarn dev.

Innlogging og utlogging mot autotest

Den lokale frontenden kjører på port 9010, for å logge seg inn må man kalle wonderwall på http://localhost:9000/oauth2/login?redirect=http://localhost:9010.

Ved innlogging gå til http://localhost:9000/oauth2/login?redirect=http://localhost:9010 - logg inn der med den brukeren du ønsker å teste med, så fortsett å jobbe videre med den lokale frontenden på http://localhost:9010.

Om man skulle få problemer med at authserver:8085 ikke finnes så må man legge inn authserver i hosts fila på maskinen: 127.0.0.1 localhost authserver

TODO

• Legge inn readme for pakkene!

Intellj og stubs

Disse må installeres manuelt, følg denne tråden:

https://intellij-support.jetbrains.com/hc/en-us/community/posts/207725245-React-import-are-not-resolved-in-WebStrom-and-Intellij-2016-2

Workspaces

• Common dev dependencies skal kun ligge på roten. ref https://medium.com/@jsilvax/a-workflow-guide-for-lerna-with-yarn-workspaces-60f97481149d

  If you have common dev dependencies, it’s better to specify them in the workspace root package.json. For instance, this can be dependencies like Jest, Husky, Storybook, Eslint, Prettier, etc.

Mocks i dev-serveren

Kan konfigureres via å sette opp en .env-fil i roten av prosjektet.

Overstyr enkeltrute (webpack/mocks/fake-error.js)

Nyttig for å teste feilsituasjoner. Overstyres som følger:

FAKE_ERROR_PATH=/fpsak/api/behandling/person/personopplysninger
FAKE_ERROR_CODE=401
FAKE_ERROR_BODY={"error":"dette fikk galt"}

Licenses and attribution

For updated information, always see LICENSE first!

For Nav-ansatte

Interne henvendelser kan sendes via Slack i kanalen #fp-frontend.