< Prosjekter

NaboWeb – løsning for sameier og borettslag

Skjermbilde fra nettsidene til Boligsameiet Gartnerihagen.
Slik ser nettsidene til sameiet mitt ut.

Boligsameiet der jeg bor har fått være prøvekaniner for NaboWeb – en løsning jeg lagde for sameier og borettslag.

Det er noen år siden jeg skrev en artikkelserie i kode24 om hvordan jeg bygde nettsider til sameiet vårt med Gatsby, Chakra UI og Contentful.

Siden den gang har jeg bygget om nettsidene til en mer moderne stack:

  • Next.js
  • Sanity som både CMS og database
  • HeroUI 3 og Tailwind CSS v4
  • Clerk for innlogging og rollebasert tilgangsstyring (RBAC)
  • Hosting på Vercel
  • Nodemailer og Amazon Simple Email Service (SES) for e-post og varsler om nytt innhold
  • Upstash Redis for å holde styr på når forrige varsel ble sendt ut

Nettsidene er live på https://gartnerihagen-askim.no/.

En stund var planen å gjøre dette til et produkt – NaboWeb – som jeg kunne selge til andre sameier og borettslag. Da jeg var selvstendig næringsdrivende utvikler (før jeg gikk over til å jobbe som konsulent på heltid), fikk jeg nemlig av og til spørsmål fra borettslag og sameier om hva det ville koste å få laget en nettside. Problemet var at mange av dem ikke hadde særlig med penger.

Oppslagstavlen og meldingssystemet er tilgjengelig bare for innloggede brukere. Beboere vil automatisk kunne få varsling ved nye innlegg.

NaboWeb-prosjektet er foreløpig lagt på is. I stedet har jeg lagt ut kildekoden åpent på GitHub – med en lisens som tillater ikke-kommersiell bruk. De gamle markedsføringssidene er tilgjengelig her.

Hva er NaboWeb?

I motsetning til tjenester som Vibbo er ikke NaboWeb en ferdig SaaS-løsning, men en skreddersydd nettside bygget med Next.js. Sidene har egne områder for innloggede beboere, der de blant annet kan:

  • se informasjon som er kun for beboere
  • bla i et dokumentarkiv med vedtekter, møtereferater og annet
  • lese og skrive på en oppslagstavle

Etter at du har klonet repoet, må du altså selv tilpasse layout, design og innhold. Du må også opprette kontoer for hosting (for eksempel hos Vercel), sette opp et prosjekt i Sanity og konfigurere Clerk og Upstash – eller andre tjenester du heller vil bruke. I tillegg må du sette opp e-postvarsling via SMTP. Jeg valgte Amazon SES, men det finnes alternativer, som SMTP2Go.

https://www.smtp2go.com/

Det er altså ingen fiks ferdig løsning – men har du litt kodeferdigheter (eller en god kode-agent) så bør det være en grei jobb å sette opp.

Slik er sidene laget

All koden ligger i et pnpm-basert monorepo med to workspaces: ett for Next.js-appen og ett for Sanity Studio, verktøyet for å redigere innhold.

Next.js-siden og Sanity ligger i samme repo. Sanitys Typegen sørger for at jeg automatisk får riktige typer i Next.js-appen.

Innholdsskjemaene er definert i Sanity, og når Next.js-appen bygges, genererer Sanity automatisk TypeScript-typer for både skjemaene og alle GROQ-spørringene. Dermed har jeg full typesikkerhet for alt som har med Sanity å gjøre, uten å skrive en eneste type selv.

Next.js hostet hos Vercel er "navet". Innholdet ligger i Sanity. Clerk håndterer innlogging og roller, og AWS SES sender e-postvarslene.

Apropos Sanity: Først vurderte jeg å bruke Supabase som database for det som ikke er redaksjonelt innhold, som dokumentarkivet og oppslagstavlen. Men det viste seg at Sanity fungerte utmerket som database for alt jeg trengte.

Bygde min egen editor

Innholdet i Sanity kan redigeres i Sanity Studio, men jeg bruker også Sanitys API-er direkte, for eksempel til opplasting av dokumenter og møtereferater.

I den første versjonen måtte man bruke Sanity Studio for å oppdatere innholdet. Jeg merket fort at enkelte i styret syntes det var tungvint å logge inn to steder – først på sameiets nettside, og deretter i Sanity Studio.

Når et innlegg lagres, sjekker serveren rollen, skriver til Sanity og tømmer cachen for akkurat den siden.

Derfor bygde jeg en teksteditor basert på @portabletext/editor, den samme editormotoren som Sanity Studio bruker. Den er bygget inn i Next.js-appen, slik at brukerne kan redigere artikler og skrive innlegg på oppslagstavlen direkte på nettsiden.

Editoren har de samme mulighetene som i Sanity Studio – men du kan bruke den direkte fra Next.js-nettsiden.

Når du trykker «Lagre» i editoren, sendes teksten som JSON til en API-rute (en Next.js Route Handler). Ruten sjekker først at brukeren har riktige tilganger, og skriver deretter til Sanity. Til slutt kaller den revalidateTag med cache-taggen til for eksempel blogginnlegget, slik at endringen vises på nettsiden med én gang.

Clerk og beskyttede ruter

Nettsidene bruker Next.js’ filsystem-baserte rutingløsning. Jeg har gruppert sider som skal kreve innlogging under ../(protected-routes)/, og så bruker jeg Clerks middleware-løsning for å beskytte disse rutene.

Vanlige brukere som kommer innom nettsiden ser bare de åpne sidene. Beboere kan logge seg inn via Clerk – og få tilsendt en innloggingslenke på e-post.

Tilgangsstyringen er rollebasert, og brukernes roller lagres som metadata på brukeren i Clerk. Styret og andre med admin-tilgang har et eget admin-grensesnitt der de kan legge til, endre og slette brukere, og tildele roller.

Når en bruker opprettes i Clerk via admin-grensesnittet, opprettes den samtidig i Sanity med samme ID. Det er Sanity-brukeren som brukes som forfatter på blogginnlegg, meldinger og kommentarer – Clerk-brukeren brukes bare til innlogging og tilgangsstyring.

Alt som skriver til Sanity (blogginnlegg, meldinger, dokumentopplastinger og så videre) går via API-ruter. Til brukeradministrasjonen i Clerk har jeg derimot valgt Server Actions, med filnavn som createUser og updateUser. De kjører på serveren og bruker Clerks Next.js-SDK til å blant annet verifisere roller før de kaller Clerks API-er.

Oppslagstavle og e-postvarsling

NaboWeb har vært et prosjekt jeg har gjort litt på nå og da – ofte etter innspill fra sameiet mitt.

Noe av det siste jeg la til, var oppslagstavlen. Tanken var at når stadig flere dropper Facebook, trengs det en enkel måte å dele beskjeder på – enten mellom beboere, eller fra styret til beboerne («Husk dugnaden i morgen!»).

Innloggede brukere kan skrive innlegg og kommentere på andres. Alt lagres i Sanitys Content Lake.

Det gikk raskt opp for meg at selv om noen faktisk begynte å bruke oppslagstavlen, ville innleggene neppe bli lest av seg selv. Jeg trengte varsling.

Hver morgen sjekker en cron-jobb om det er kommet noe nytt siden forrige utsending. Hvis ikke, sendes ingen e-post.

Varslingsløsningen er forholdsvis enkel. En cron-jobb hos Vercel kaller en API-rute hver morgen kl 06:00, som gjør følgende:

  • Sjekker i en Redis-database tidspunktet for forrige utsending
  • Spør Sanity etter nye meldinger, kommentarer, blogginnlegg, referater og dokumenter siden forrige utsending
  • Henter oversikt over brukere som har takket ja til å bli varslet på e-post (ligger som metadata på brukeren i Clerk)
  • Sender e-post med oversikt over nytt innhold via nodemailer og AWS SES (Simple E-mail Service)
De som ønsker det kan få varsling på e-post når det er publisert nytt innhold på nettsidene.

Er det ikke noe nytt innhold, sendes selvfølgelig ingen e-post.

Målet: enkelt å bruke

Det hele startet som en enkel nettside, og har siden vokst gradvis etter hvert som nye behov har dukket opp.

I starten kodet jeg alt for hånd. Den siste tiden har jeg brukt AI-agenter til deler av videreutviklingen, blant annet av publiseringsløsningen og brukeradministrasjonen. Men det aller meste av kodebasen er fortsatt skrevet av meg.

Målet har hele tiden vært en løsning som er så enkel som mulig å bruke, både for styret og for beboerne. Det synes jeg at jeg har fått til.