Kanban Pro

Cloud Sync

Lär dig hur du delar molnmappar och samarbetar i realtid.

Så fungerar Cloud Sync

Kanban Pro är ett lokalt program. Varje projekt är en mapp på ditt filsystem som innehåller Markdown-biljettpfiler och en konfigurationskatalog .kanban/. Det finns inga konton, inga proprietära molntjänster och inga registreringar.

För att samarbeta med andra placerar du din projektmapp i en molnsynkroniserad katalog — iCloud Drive, Dropbox, Google Drive, OneDrive eller någon nätverksenhet. Varje deltagare öppnar samma mapp i Kanban Pro, och ändringar förplantades automatiskt genom molnleverantörens filsynkronisering.

Tips

Ingen Kanban Pro-konto krävs. Synkronisering använder filsystemet direkt — om din molnleverantör kan synkronisera en mapp fungerar Kanban Pro med den.

Ställa in ett delat projekt

  1. Välj en molnmapp. Öppna Finder och navigera till din molnleverantörs synkroniseringskatalog (t.ex. ~/Library/Mobile Documents/com~apple~CloudDocs/ för iCloud Drive, ~/Dropbox/ för Dropbox, eller Google Drive-/OneDrive-monteringen i ditt Finder-sidpanel).
  2. Skapa en projektmapp. Skapa en ny mapp för ditt projekt, t.ex. Team Board.
  3. Öppna det i Kanban Pro. Starta Kanban Pro, klicka på Öppna mapp, och välj den mapp du just skapade. Kanban Pro initialiserar katalogen .kanban/ och du kan börja lägga till kolumner och biljetter.
  4. Dela mappen. Använd din molnleverantörs delningsfunktioner för att bjuda in medarbetare. Högerklicka på mappen i iCloud Drive och välj Dela. I Dropbox eller Google Drive använder du delningsdialogrutan. I OneDrive högerklickar du och väljer Dela → Dela via OneDrive. Varje medarbetare bör sedan öppna samma synkroniserade mapp i sin egen kopia av Kanban Pro.

Tips

När du delar ställer du in behörigheter till Kan redigera (inte Kan visa) så att medarbetare kan skapa och uppdatera biljetter.

Rekommenderad mappstruktur

När Kanban Pro initialiserar ett projekt skapar det följande struktur i din valda mapp:

Team Board/
  .kanban/ — projektkonfiguration
    board.json — kolumner, inställningar, anpassade fält
    locks/ — aktiva redigeringslåsningar (se nedan)
    activity/ — aktivitetsloggposter
  attachments/ — överförda bilder och filer
  KAN-1.md — biljett (Markdown + YAML frontmatter)
  KAN-2.md
  KAN-3.md

Varje biljett är en enkel Markdown-fil med YAML frontmatter för metadata (status, prioritet, tilldelad till, taggar, anpassade fält). Du kan läsa, redigera eller säkerhetskopiera dessa filer med vilket som helst verktyg — inklusive AI-kodningsagenter som arbetar direkt med filsystemet.

Realtidssynkronisering och konfliktfri redigering

Kanban Pro övervakar projektmappen för filsystemändringar med hjälp av en realtidsfilvakare. När en medarbetare sparar en biljett eller uppdaterar bordkonfigurationen detekteras ändringen inom sekunder och användargränssnittet uppdateras automatiskt.

Hur konflikter undviks

  • Biljettsperrning: När du öppnar en biljett för redigering skapar Kanban Pro en liten låsfil i .kanban/locks/. Andra användare ser biljetten som låst och kan inte skriva över dina ändringar. Låsfiler synkroniseras genom din molnleverantör så alla medarbetare ser samma låsstatus.
  • Atomära skrivningar: Varje biljett är en enkel Markdown-fil. Kanban Pro skriver först till en tillfällig fil och byter sedan namn på den — vilket förhindrar delvisa uppdateringar även om molnleverantören synkroniserar under skrivningen.
  • Detektering av skrivslut: Kanban Pro väntar tills filer stabiliseras (2 sekunder för biljetter, 1 sekund för bordkonfiguration) innan de läses. Detta säkerställer att molnsynkroniseringen är klar med skrivningen innan appen behandlar ändringen.
  • Senaste-skrivning-vinner för bordkonfiguration: Kolumnordning, inställningar och anpassade fältdefinitioner lagras i board.json. Om två användare ändrar bordsinstillningar samtidigt vinner den senaste skrivningen — men detta är sällsynt i praktiken eftersom bordkonfiguration sällan ändras.

Förstå låsfiler

Katalogen .kanban/locks/ innehåller tillfälliga låsfiler som indikerar vilka biljetter som för närvarande redigeras och av vem. Varje låsfil är ett litet JSON-dokument:

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

Låsfiler skapas när en biljett öppnas för redigering och tas bort när redigeraren stängs. De gör det möjligt för Kanban Pro att visa en visuell indikator på låsta biljetter så medarbetare vet att någon arbetar på dem.

Lösa stale locks

Om Kanban Pro kraschar eller en enhet går offline kan en låsfil stanna kvar utan att rensas. Detta kallas en föråldrad låsning.

Föråldrad låsning?

Om en biljett verkar låst men ingen redigerar den kan du säkert ta bort motsvarande fil i .kanban/locks/ med Finder eller terminalen. Kanban Pro detekterar borttagningen och låser upp biljetten.

Kanban Pro detekterar också låsningar äldre än 24 timmar och flaggar dem som potentiellt föråldrade i användargränssnittet, vilket ger dig möjlighet att tvinga upplåsning direkt från appen.

Molnleverantörsnoteringar

iCloud Drive

iCloud Drive fungerar sömlöst med Kanban Pro. macOS håller nyligen använda filer nedladdade lokalt, så ditt kort laddar omedelbar. Om en biljetfil har tagits bort från lokal lagring (visad som en liten .icloud platshållare i Finder) laddar macOS ner den på begäran — du kan märka en kort fördröjning när du öppnar mycket stora projekt för första gången.

Dela en iCloud Drive-mapp

  1. Öppna Finder och navigera till din iCloud Drive-mapp i sidopanelen.
  2. Högerklicka på projektmappen och välj Dela → Samarbeta.
  3. Ställ in behörigheter till "Endast inbjudna personer" och "Kan göra ändringar".
  4. Ange e-postadresser för dina medarbetare och klicka Dela.

Tips

För att hålla projektfiler alltid tillgängliga på din Mac högerklickar du på projektmappen i Finder och väljer Behåll nedladdad. Detta förhindrar macOS från att ta bort filer för att spara plats.

Dropbox

Dropbox fungerar väl med Kanban Pro, men dess Smart Sync-funktion kan ta bort biljetfiler för att spara diskutrymme. Markera din projektmapp som Tillgänglig offline för bästa prestanda så alla filer blir kvar på din Mac.

Ställa in offline-åtkomst

  1. Öppna Finder och navigera till din Dropbox-mapp.
  2. Högerklicka på projektmappen.
  3. Välj Gör tillgänglig offline.
  4. En grön bockmark bekräftar att mappen nu lagras lokalt.

Dela en Dropbox-mapp

  1. Högerklicka på projektmappen i Finder.
  2. Klicka på Dela… (bredvid Dropbox-ikonen).
  3. Klicka på Lägg till personer, ange e-postadresser och ställ in behörigheter till Kan redigera.
  4. Klicka på Dela för att skicka inbjudan.

Google Drive

Google Drive for Desktop erbjuder två synkroniseringslägen. För Kanban Pro rekommenderas Spegla filer-läget starkt eftersom det behåller en fullständig lokal kopia av ditt projekt — vilket säkerställer omedelbar åtkomst utan nedladdningsfördröjningar.

Byta till speglarläge

  1. Klicka på Google Drive-ikonen i din menyrad.
  2. Öppna Inställningar.
  3. Under "Min Drive-synkroniseringsalternativ" väljer du Spegla filer.
  4. Google Drive laddar ned alla filer till din Mac. Detta kan ta ett tag för stora bibliotek.

Varning

Standardläget "Stream filer" laddar ned filer på begäran vilket kan orsaka märkbar latens när Kanban Pro läser biljetfiler. Byta till speglarläge för bästa upplevelse.

Dela en Google Drive-mapp

  1. Högerklicka på projektmappen i Finder (inuti din Google Drive-montering).
  2. Klicka på Dela.
  3. Ange e-postadresser för medarbetare och ställ in åtkomst till Redigerare.
  4. Klicka på Dela för att skicka inbjudan.

OneDrive

OneDrive for Mac fungerar väl med Kanban Pro. Som andra molntjänster erbjuder OneDrive en "Filer på begäran"-funktion som kan ta bort filer från lokal lagring. För bästa resultat ställer du din projektmapp till Behåll alltid på denna enhet.

Håll filer tillgängliga lokalt

  1. Öppna Finder och navigera till din OneDrive-mapp.
  2. Högerklicka på projektmappen.
  3. Välj Behåll alltid på denna enhet.
  4. En grön bockmark bekräftar att mappen förblir nedladdad.

Dela en OneDrive-mapp

  1. Högerklicka på projektmappen i Finder.
  2. Välj Dela → Dela via OneDrive.
  3. Ange e-postadresser för medarbetare och ställ in behörigheter till Kan redigera.
  4. Klicka på Skicka.

Tips

Undvik specialtecken i mapp- eller filnamn (:, *, ?, |) — OneDrive stöder dem inte och kan orsaka synkroniseringsfel.

Nätverksenheter och NAS

Kanban Pro fungerar med vilken monterad nätverksenhet som helst (SMB, AFP, NFS). Se till att enheten förblir monterad medan du arbetar. Om nätverksanslutningen faller pausas filövervakningen i Kanban Pro och återupptas när enheten blir tillgänglig igen.

Bästa praxis

  • Håll projektmappar tillgängliga offline. Markera din projektmapp som "Tillgänglig offline", "Spegla filer", "Behåll alltid på denna enhet" eller "Behåll nedladdad" beroende på din molnleverantör. Detta undviker fördröjningar orsakade av nedladdningar av filer på begäran.
  • Håll mappstrukturen platt. Undvik djupt kapslade mappar — en platt layout förbättrar synkroniseringspålitligheten på alla leverantörer.
  • Kontrollera synkroniseringsstatus innan du stänger din Mac. Se efter synkroniseringsikonskolan i Finder eller menyradel. Om du stänger av under synkronisering kan det lämna delvisa filer som förvirrar medarbetare.
  • Behåll fri lagring. Håll minst 10–15% fri diskutrymme på din Mac och minst 20% fri molnlagring. Låg lagring kan blockera synkronisering eller utlösa borttagning av fil.
  • Använd samma molnleverantör i hela teamet. Blandning av leverantörer (t.ex. en person på iCloud, en annan på Dropbox) kräver att varje person har sin egen kopia — de synkroniseras inte med varandra.

Felsökning

  • Ändringar visas inte: Kontrollera att din molnleverantör synkroniseras aktivt. Se efter synkroniseringsikonskolan i Finder eller din molnleverantörs menyradsikon. Kanban Pro uppdateras inom sekunder efter att en filförändring har upptäckts — om filen ännu inte har synkroniserats kan appen inte se den.
  • Biljettpermuta låst: Se avsnittet om föråldrade låsningar ovan. Du kan tvinga upplåsning från appen (för låsningar äldre än 24 timmar) eller ta bort låsfilen manuellt i .kanban/locks/.
  • Biljetter saknas efter synkronisering: Vissa molnleverantörer försenar synkroniseringen av nya filer. Vänta en stund och kontrollera din leverantörs synkroniseringsstatus. Om problemet kvarstår kontroller du att mappen är inställd på offline-synkronisering. Kontrollera i iCloud Drive att filer inte har ersatts av .icloud platshållarfiler.
  • Långsam inledande inläsning: Om din molnleverantör strömmar filer på begäran kan inledande inläsning ta längre tid medan filer laddas ned. Byta till offline eller speglarläge för bästa prestanda.
  • Synkronisering pausade oväntat: Vissa molnleverantörer pausar synkronisering när din Mac körs på batteri eller har lågt diskutrymme. Kontrollera din leverantörs menyradsikon för pausindikationer och återuppta synkronisering om nödvändigt.
  • Konflikterade kopifiler visas: Om du ser filer med "conflicted copy" i Finder redigerade två personer förmodligen samma fil medan offline. Öppna båda filerna för att jämföra, behåll rätt version och ta bort konflikterad kopia.