Kanban Pro

Cloud Sync

Lær hvordan du deler skymapper og samarbeider i sanntid.

Hvordan Cloud Sync fungerer

Kanban Pro er et lokalt program. Hvert prosjekt er en mappe på filsystemet ditt som inneholder Markdown-billett-filer og en konfigurasjonsmapp .kanban/. Det er ingen kontoer, ingen proprietære skytjenester og ingen påmeldinger.

For å samarbeide med andre plasserer du prosjektmappen i en sky-synkronisert mappe — iCloud Drive, Dropbox, Google Drive, OneDrive eller et nettverkstasteri. Hver deltaker åpner samme mappe i Kanban Pro, og endringer forplantes automatisk gjennom skyutbyderens filsynkronisering.

Tips

Ingen Kanban Pro-konto er påkrevd. Synkronisering bruker filsystemet direkte — hvis skyutbyderen din kan synkronisere en mappe, fungerer Kanban Pro med den.

Oppsetting av et delt prosjekt

  1. Velg en skymapp. Åpne Finder og naviger til synkroniseringsmappen til skyutbyderen (f.eks. ~/Library/Mobile Documents/com~apple~CloudDocs/ for iCloud Drive, ~/Dropbox/ for Dropbox, eller Google Drive-/OneDrive-monteringen i sidepanelet ditt).
  2. Opprett en prosjektmappe. Opprett en ny mappe for prosjektet ditt, f.eks. Team Board.
  3. Åpne det i Kanban Pro. Start Kanban Pro, klikk Åpne mappe, og velg mappen du opprettet. Kanban Pro initialiserer mappen .kanban/ og du kan begynne å legge til kolonner og billetter.
  4. Del mappen. Bruk deling-funksjonene til skyutbyderen din for å invitere medarbeidere. Høyreklikk på mappen i iCloud Drive og velg Del. I Dropbox eller Google Drive bruker du delingsdialogen. I OneDrive høyreklikker du og velger Del → Del via OneDrive. Hver medarbeider bør så åpne samme synkroniserte mappe i sin egen kopi av Kanban Pro.

Tips

Når du deler, setter du tillatelser til Kan redigere (ikke Kan vise) slik at medarbeidere kan opprette og oppdatere billetter.

Anbefalt mappestruktur

Når Kanban Pro initialiserer et prosjekt, oppretter det følgende struktur i mappen din:

Team Board/
  .kanban/ — prosjektkonfigurasjon
    board.json — kolonner, innstillinger, tilpassede felt
    locks/ — aktive redigeringslåser (se nedenfor)
    activity/ — aktivitetsloggoppføringer
  attachments/ — opplastede bilder og filer
  KAN-1.md — billett (Markdown + YAML frontmatter)
  KAN-2.md
  KAN-3.md

Hver billett er en enkel Markdown-fil med YAML frontmatter for metadata (status, prioritet, tilordnet til, merker, tilpassede felt). Du kan lese, redigere eller sikkerhetskopiere disse filene med hvilket som helst verktøy — inkludert AI-kodingsagenter som arbeider direkte med filsystemet.

Sanntidssynkronisering og konfliktfri redigering

Kanban Pro overvåker prosjektmappen for filsystemendringer ved hjelp av en sanntidsfilmonitor. Når en medarbeider lagrer en billett eller oppdaterer boardkonfigurasjonen, detekteres endringen innen sekunder og brukergrensesnittet oppdateres automatisk.

Hvordan konflikter unngås

  • Billett-låsing: Når du åpner en billett for redigering, oppretter Kanban Pro en liten låsefil i .kanban/locks/. Andre brukere ser billetten som låst og kan ikke overskrive endringene dine. Låsefiler synkroniseres gjennom skyutbyderen din slik at alle medarbeidere ser samme låsetilstand.
  • Atomare skrivinger: Hver billett er en enkelt Markdown-fil. Kanban Pro skriver til en midlertidig fil først, deretter gir den nytt navn — som forhindrer delvise oppdateringer selv om skyutbyderen synkroniserer under skrivingen.
  • Deteksjon av skriveabslutning: Kanban Pro venter til filene stabiliseres (2 sekunder for billetter, 1 sekund for boardkonfigurasjon) før lesing. Dette sikrer at skysynkronisering er ferdig med å skrive før appen behandler endringen.
  • Siste-skrivning-vinner for boardkonfigurasjon: Kolonnerekkefølge, innstillinger og tilpassede feltdefinisjoner lagres i board.json. Hvis to brukere endrer boardinnstillinger samtidig, vinner siste skriving — men dette er sjeldent i praksis siden boardkonfigurasjon endrer seg sjelden.

Forstå låsefiler

Mappen .kanban/locks/ inneholder midlertidige låsefiler som indikerer hvilke billetter som for øyeblikket blir redigert og av hvem. Hver låsefil er et lite JSON-dokument:

{
  "ticket": "KAN-42",
  "user": "Alice",
  "device": "Alice-MacBook",
  "timestamp": "2026-03-09T10:30:00Z"
}

Låsefiler opprettes når en billett åpnes for redigering og fjernes når editoren lukkes. De lar Kanban Pro vise en visuell indikator på låste billetter slik at medarbeidere vet at noen arbeider på dem.

Løsning av foreldet låser

Hvis Kanban Pro krasjer eller en enhet går offline, kan en låsefil bli igjen uten å bli rengjort. Dette kalles en foreldet låse.

Foreldet låse?

Hvis en billett ser låst ut men ingen redigerer den, kan du trygt slette den tilsvarende filen i .kanban/locks/ ved å bruke Finder eller terminalen. Kanban Pro detekterer slettingen og låser opp billetten.

Kanban Pro detekterer også låser eldre enn 24 timer og merker dem som potensielt foreldete i brukergrensesnittet, noe som gir deg muligheten til å tvinge opplåsing direkte fra appen.

Notater om skyutbyderen

iCloud Drive

iCloud Drive fungerer sømløst med Kanban Pro. macOS holder nylig få tilganger til filer nedlastet lokalt, slik at boardet ditt lastes øyeblikkelig. Hvis en billett-fil er blitt fjernet fra lokal lagring (vist som en liten .icloud plassholder i Finder), laster macOS den på forespørsel ned — du kan merke en kort forsinkelse når du åpner meget store prosjekter for første gang.

Deling av en iCloud Drive-mappe

  1. Åpne Finder og naviger til iCloud Drive-mappen din i sidepanelet.
  2. Høyreklikk på prosjektmappen og velg Del → Samarbeid.
  3. Sett tillatelser til "Bare inviterte personer" og "Kan gjøre endringer".
  4. Skriv inn e-postadresser til medarbeidere og klikk Del.

Tips

For å holde prosjektfiler alltid tilgjengelig på Mac-en din, høyreklikk på prosjektmappen i Finder og velg Behold nedlastet. Dette forhindrer macOS fra å fjerne filer for å spare plass.

Dropbox

Dropbox fungerer bra med Kanban Pro, men dens Smart Sync-funksjon kan fjerne billett-filer for å spare diskplass. Marker prosjektmappen som Tilgjengelig frakoblet for best resultater, slik at alle filer blir på Mac-en din.

Oppsetting av frakoblet tilgang

  1. Åpne Finder og naviger til Dropbox-mappen din.
  2. Høyreklikk på prosjektmappen.
  3. Velg Gjør tilgjengelig frakoblet.
  4. En grønn hakk bekrefter at mappen nå holdes lokalt.

Deling av en Dropbox-mappe

  1. Høyreklikk på prosjektmappen i Finder.
  2. Klikk Del… (ved siden av Dropbox-ikonet).
  3. Klikk Legg til personer, skriv inn e-postadresser, og sett tillatelser til Kan redigere.
  4. Klikk Del for å sende invitasjonen.

Google Drive

Google Drive for Desktop tilbyr to synkroniseringsmodi. For Kanban Pro anbefales Speiling av filer-modus sterkt fordi den beholder en fullstendig lokal kopi av prosjektet ditt — og sikrer øyeblikkelig tilgang uten nedlastingsforsinkelser.

Bytte til speilings-modus

  1. Klikk på Google Drive-ikonet i menylinjen din.
  2. Åpne Innstillinger.
  3. Under "Min Drive synkroniseringsalternativ" velger du Speiling av filer.
  4. Google Drive laster ned alle filer til Mac-en din. Dette kan ta litt tid for store biblioteker.

Advarsel

Standard "Strøm filer"-modus laster ned filer på forespørsel, noe som kan forårsake merkbar ventetid når Kanban Pro leser billett-filer. Bytt til speilings-modus for best opplevelse.

Deling av en Google Drive-mappe

  1. Høyreklikk på prosjektmappen i Finder (inne i Google Drive-monteringen din).
  2. Klikk Del.
  3. Skriv inn e-postadresser til medarbeidere og sett tilgang til Redaktør.
  4. Klikk Del for å sende invitasjonen.

OneDrive

OneDrive for Mac fungerer bra med Kanban Pro. Som andre skytjenester tilbyr OneDrive en Filer på forespørsel-funksjon som kan fjerne filer fra lokal lagring. For best resultater setter du prosjektmappen til Behold alltid på denne enheten.

Hold filer tilgjengelig lokalt

  1. Åpne Finder og naviger til OneDrive-mappen din.
  2. Høyreklikk på prosjektmappen.
  3. Velg Behold alltid på denne enheten.
  4. En grønn hakk bekrefter at mappen forblir nedlastet.

Deling av en OneDrive-mappe

  1. Høyreklikk på prosjektmappen i Finder.
  2. Velg Del → Del via OneDrive.
  3. Skriv inn e-postadresser til medarbeidere og sett tillatelser til Kan redigere.
  4. Klikk Send.

Tips

Unngå spesialtegn i mappe- eller filnavn (:, *, ?, |) — OneDrive støtter dem ikke og kan forårsake synkroniseringsfeil.

Nettverkstasteria og NAS

Kanban Pro fungerer med ethvert montert nettverksvolum (SMB, AFP, NFS). Sørg for at tasteriet forblir montert mens du arbeider. Hvis nettverksforbindelsen faller bort, pauser Kanban Pro filmonitoringen og gjenopptar når volumet blir tilgjengelig igjen.

Best praksis

  • Hold prosjektmapper tilgjengelig frakoblet. Marker prosjektmappen som "Tilgjengelig frakoblet", "Speiling av filer", "Behold alltid på denne enheten" eller "Behold nedlastet" avhengig av skyutbyderen din. Dette unngår forsinkelser forårsaket av nedlastinger av filer på forespørsel.
  • Hold mappestrukturen flat. Unngå dypt nestede mapper — et flatt oppsett forbedrer synkroniseringspåliteligheten på tvers av alle leverandører.
  • Sjekk synkroniseringsstatus før du lukker Mac-en din. Se etter synkroniseringsikonet i Finder eller menylinjen. Avstenging under synkronisering kan etterlate delvise filer som forvirrer medarbeidere.
  • Bevar fri lagring. Hold minst 10–15% fri diskplass på Mac-en og minst 20% fri skylagring. Lav lagring kan standse synkronisering eller utløse filfjerning.
  • Bruk samme skyutbyrer på tvers av teamet. Blanding av leverandører (f.eks. en person på iCloud, en annen på Dropbox) krever at hver person har sin egen kopi — de vil ikke synkroniseres med hverandre.

Feilsøking

  • Endringer vises ikke: Sjekk at skyutbyderen din synkroniseres aktivt. Se etter synkroniseringsikonet i Finder eller skyutbyderens menylinjeikon. Kanban Pro oppdateres innen sekunder etter å ha detektert en fileendring — hvis filen ennå ikke er blitt synkronisert, kan ikke appen se den.
  • Billett låst fast: Se delen om foreldete låser ovenfor. Du kan tvinge opplåsing fra appen (for låser eldre enn 24 timer) eller manuelt slette låsefilen i .kanban/locks/.
  • Billetter mangler etter synkronisering: Noen skyudbydere forsinker synkroniseringen av nye filer. Vent litt og sjekk synkroniseringsstatus til skyutbyderen. Hvis problemet vedvarer, kontroller at mappen er satt til frakoblet synkronisering. I iCloud Drive kontroller at filer ikke er erstattet av .icloud plassholder-filer.
  • Langsom innledende innlasting: Hvis skyutbyderen din strømmer filer på forespørsel, kan innledende innlasting ta lengre tid mens filer blir lastet ned. Bytt til frakoblet eller speilings-modus for best ytelse.
  • Synkronisering pauset uventet: Noen skyudbydere pauser synkronisering når Mac-en din kjører på batteri eller har lav diskplass. Sjekk skyutbyderens menylinjeikon for pauseindikatorer og gjenoppta synkronisering om nødvendig.
  • Konflikterte kopifiler vises: Hvis du ser filer som heter "conflicted copy" i Finder, redigerte to personer sannsynligvis samme fil mens frakoblet. Åpne begge filer for å sammenligne, behold riktig versjon og slett konfliktert kopi.