https://github.com/navikt/k9-sak-web
Frontend for K9-sak
https://github.com/navikt/k9-sak-web
k9-sak nav react sykdom-i-familien
Last synced: 11 months ago
JSON representation
Frontend for K9-sak
- Host: GitHub
- URL: https://github.com/navikt/k9-sak-web
- Owner: navikt
- License: mit
- Created: 2020-01-06T12:34:48.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-12-02T15:03:40.000Z (over 1 year ago)
- Last Synced: 2024-12-03T07:40:05.388Z (over 1 year ago)
- Topics: k9-sak, nav, react, sykdom-i-familien
- Language: TypeScript
- Homepage: https://navikt.github.io/k9-sak-web/
- Size: 375 MB
- Stars: 3
- Watchers: 11
- Forks: 0
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# k9-sak-frontend
Monorepo for Frontend kode for k9-sak.
[](https://github.com/navikt/k9-sak-web/actions?query=workflow%3A%22Deploy+Docker+image%22)
[](https://github.com/prettier/prettier)
## Komme i gang
Først installer node: `brew install node`
Så installer yarn: `brew install yarn`
For å få hentet pakker fra GitHub sitt pakkeregistry må man sette opp lokal NPM med autentisering mot GitHub med en Personal Access Token (PAT) med `read:packages`-tilgang i lokalt utviklingsmiljø, før man gjør `yarn install`. GitHub har en guide på hvordan man gjør dette [her](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#authenticating-to-github-packages).
TLDR er å opprette en GitHub PAT med kun `read:packages`-tilgang, enable SSO, og putte det i en egen ~/.yarnrc.yml-fil slik:
```
npmRegistries:
https://npm.pkg.github.com:
npmAlwaysAuth: true
npmAuthToken:
```
Merk at dette _ikke_ skal sjekkes inn i versjonskontroll.
Når dette er gjort kan man kjøre dette på rot av repo'et for å kjøre opp lokalt utviklingsmiljø:
```
yarn install
yarn dev
```
Storybook brukes også til utvikling, startes med `yarn storybook`. Se ellers _package.json_ for mer info.
## 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.
### Feature toggles
Aktiveres ved å definere en eller flere features i `.env.development`fil i _envDir_ katalogen
## Pakkeoppdatering
### Avhengigheter som må ha samme versjon
Noen sub-pakker i dette prosjekt har avhengigheter til kode fra [ft-frontend-saksbehandling](https://github.com/navikt/ft-frontend-saksbehandling).
Samtidig har disse sub-pakkene felles avhengigheter med koden i [ft-frontend-saksbehandling](https://github.com/navikt/ft-frontend-saksbehandling).
Dette gjør at oppdatering av disse avhengighetene må gjøres synkronisert, slik at vi unngår dupliserte avhengigheter. Viss versjonsnr ikke er
nøyaktig likt vil yarn laste ned flere kopier og installere node_modules med disse nede i avhengighetstreet. Det kan føre til kompileringsfeil,
eller kjøretidsfeil viss avhengighet som blir duplisert inneholder css.
Så ved oppdatering av følgende avhengigheter må man samtidig sørge for at alle pakker som starter på **@navikt/ft-** blir oppdatert
til en versjon som har samme versjon av disse avhengighetene.
- @navikt/aksel-icons
- @navikt/ds-css
- @navikt/ds-react
- @navikt/ds-tailwind
- @navikt/ft-plattform-komponenter
- react-hook-form
- react-router-dom
Eventuelt må man overstyre versjonene med resolutions i package.json slik at de blir like på tvers av avhengighetene.
## Modernisering med packages/v2
For å prøve å skape en mer robust kodebase har vi starta å flytte/skrive om en del eldre kode i _packages/v2_ katalogen.
Kode som legges inn her blir kontrollert av en strengere tsconfig.json. Gammel kode kan importere fra packages/v2, men
det motsatte skal ikke skje, kode under _packages/v2_ skal aldri importere kode som ikke ligger under _v2_. På denne
måten får vi gjort en gradvis overgang til bedre kontrollert typescript.
Mer info om dette i [v2/README](./packages/v2/README.md)
## Bygg og utrulling
Ved merge av **PR til master** branch blir koden bygd inn i et Docker image og rulla ut til testmiljø på https://k9.dev.intern.nav.no.
Etter godkjenning i pipeline blir samme Docker image rulla ut i produksjon på https://k9.intern.nav.no/.
Vi har også støtte for å rulle ut mer eksperimentelle endringer for test til https://k9-next1.dev.intern.nav.no. Dette
skjer automatisk ved merge av **PR til dev-next1** branch. Denne utrulling lever i 10 dager. Hvis det går lenger tid mellom
hver nye utrulling her stenges servicen ned inntil det skjer en ny utrulling.
### Storybook
Katalog med brukergrensesnitt-komponenter blir publisert i storybook på https://navikt.github.io/k9-sak-web/
## For NAV-ansatte
Interne henvendelser kan sendes via Slack i kanalen **#sif-teknisk**.