Dokumentacja

Szybki start

SimpleBoard to wizualna tablica Kanban — organizujesz pracę przeciągając karty między kolumnami. Żadnego wdrażania, żadnych kursów. Zacznij w cztery kroki:

1. Zarejestruj się na app.simpleboard.pl/register — nie potrzebujesz karty kredytowej.
2. Utwórz pierwszą tablicę — kliknij „+" na stronie głównej, wpisz nazwę i gotowe.
3. Zaproś zespół — skopiuj link zaproszenia lub wpisz adresy e-mail.
4. Dodaj karty — kliknij „+" w lewym górnym rogu kolumny lub „+ ADD CARD" na dole kolumny.

Tablice i kolumny

Tablica to przestrzeń robocza dla jednego projektu, zespołu lub klienta. Możesz mieć nieograniczoną liczbę tablic.

Tworzenie tablicy

Na stronie głównej kliknij „+", wpisz nazwę i opcjonalnie wybierz kolor lub ikonę. Tablica startuje z domyślnymi kolumnami: Backlog, W trakcie, Gotowe — możesz je dowolnie zmienić.

Kolumny

• Dodaj kolumnę klikając przycisk „+ Dodaj kolumnę" na końcu listy.
• Zmień nazwę kolumny klikając menu ⋮ na jej nagłówku, a następnie wybierając „Zmień nazwę".
• Przeciągnij kolumnę w inne miejsce (chwyt za nagłówek).
• Oznacz kolumnę jako „Gotowe" przez menu ⋮ — karty z tej kolumny będą traktowane jako ukończone w statystykach.

Uprawnienia tablicy

Rola	Co może robić
Admin	Zarządza tablicą: ustawienia, zaproszenia, zmiana ról, usuwanie kolumn i kart
Uczestnik	Dodaje i edytuje karty, komentuje, rejestruje czas pracy

Karty

Karta to pojedyncze zadanie. Kliknij kartę aby otworzyć panel szczegółów.

Co możesz dodać do karty

• Tytuł i opis — edytor z bogatym formatowaniem.
• Przypisanie — jeden członek zespołu odpowiedzialny za zadanie.
• Termin (due date) — karta zostaje oznaczona gdy termin mija.
• Etykiety — kolorowe tagi do kategoryzacji (np. „Bug", „Feature").
• Rejestracja czasu — timer lub ręczny wpis czasu bezpośrednio na karcie (gdy funkcja jest włączona dla tablicy).
• Komentarze — dyskusja w kontekście zadania.

Przenoszenie kart

Przeciągnij kartę między kolumnami metodą drag & drop. Na urządzeniach mobilnych przesuń kartę w lewo lub w prawo aby przesunąć ją do sąsiedniej kolumny.

Rejestracja czasu pracy

SimpleBoard pozwala śledzić czas spędzony na każdym zadaniu — bezpośrednio na kartach, bez osobnych aplikacji do timesheetów.

Timer na karcie

Otwórz kartę i kliknij „Uruchom timer" (ikona zegara). Timer działa w tle — możesz przełączać karty i tablice. Kliknij „Stop" aby zapisać czas. Wpis pojawia się na liście rejestracji czasu danej karty z dokładnością do sekund.

Ręczne logowanie czasu

Jeśli zapomnisz uruchomić timer — możesz dodać czas ręcznie. Na karcie, w sekcji „Czas pracy", kliknij „Dodaj wpis" i wpisz czas w minutach lub godzinach. Możesz też podać datę wpisu — przydatne przy uzupełnianiu historycznych wpisów.

Zespół i zaproszenia

Kliknij ikonę „Zaproś członka" (👤+) w nagłówku tablicy. W oknie zaproszenia wpisz adres e-mail i wybierz rolę (Admin lub Uczestnik) — zaproszenie zostanie wysłane e-mailem. Dla każdego oczekującego zaproszenia możesz też skopiować link i wysłać go bezpośrednio.

Aby zarządzać obecnymi członkami — kliknij ikonki awatarów w nagłówku tablicy. W oknie członków Admin może zmienić role lub usunąć uczestników z tablicy.

Przestrzeń dyskowa

Każde konto administratora dysponuje 10 GB przestrzeni na załączniki i pliki dodawane do kart. Limit jest wspólny dla wszystkich tablic w ramach jednego konta.

Bieżące zużycie widoczne jest w Ustawienia → Konto → Przestrzeń dyskowa.

Powiadomienia

SimpleBoard informuje Cię gdy: zostaniesz przypisany do karty, ktoś doda komentarz do karty na której pracujesz, lub karta zostanie przeniesiona do innej kolumny.

Konfiguracja w Ustawienia → Powiadomienia. Dostępne kanały: powiadomienia w aplikacji oraz e-mail.

API

SimpleBoard udostępnia REST API — możesz budować własne integracje, automatyzacje i narzędzia wewnętrzne. Wszystkie odpowiedzi są w formacie JSON.

Uwierzytelnianie

Generujesz klucz API w Ustawienia → API → Nowy klucz. Klucz przekazujesz w nagłówku każdego żądania:

Authorization: Bearer twój_klucz_api

Bazowy URL

https://api.simpleboard.pl/v1

Limity

Plan	Limit żądań
Trial / Miesięczny	1 000 żądań / godzinę
Roczny	5 000 żądań / godzinę

Nagłówki X-RateLimit-Remaining i X-RateLimit-Reset w odpowiedzi informują o pozostałych żądaniach i czasie resetu.

Endpointy — Tablice

Metoda	Endpoint	Opis
GET	/boards	Lista wszystkich Twoich tablic
GET	/boards/{id}	Szczegóły tablicy
POST	/boards	Utwórz nową tablicę
PATCH	/boards/{id}	Zaktualizuj tablicę
DELETE	/boards/{id}	Usuń tablicę

Endpointy — Karty

Metoda	Endpoint	Opis
GET	/boards/{id}/cards	Lista kart na tablicy
GET	/cards/{id}	Szczegóły karty
POST	/boards/{id}/cards	Utwórz kartę
PATCH	/cards/{id}	Zaktualizuj kartę
DELETE	/cards/{id}	Usuń kartę
POST	/cards/{id}/time-entries	Dodaj wpis czasu pracy
GET	/cards/{id}/time-entries	Lista wpisów czasu

Przykłady

Pobranie listy tablic:

curl https://api.simpleboard.pl/v1/boards \
  -H "Authorization: Bearer twój_klucz_api"

Odpowiedź:

{
  "data": [
    {
      "id": "brd_01j9xk2m",
      "name": "Sprint Q2",
      "created_at": "2026-03-01T10:00:00Z",
      "members_count": 5
    }
  ],
  "meta": { "total": 1 }
}

Utworzenie nowej karty:

curl -X POST https://api.simpleboard.pl/v1/boards/brd_01j9xk2m/cards \
  -H "Authorization: Bearer twój_klucz_api" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Nowe zadanie", "column_id": "col_backlog", "assignee_ids": ["usr_abc"] }'

Dodanie wpisu czasu pracy:

curl -X POST https://api.simpleboard.pl/v1/cards/crd_xyz/time-entries \
  -H "Authorization: Bearer twój_klucz_api" \
  -H "Content-Type: application/json" \
  -d '{ "duration_seconds": 5400, "date": "2026-04-18", "note": "Implementacja" }'

Webhooki

Webhooki pozwalają SimpleBoard na aktywne powiadamianie Twojego systemu o zdarzeniach — zamiast odpytywać API, SimpleBoard sam wysyła żądanie POST do Twojego URL gdy coś się dzieje.

Tworzenie webhooka

1. Na stronie tablicy kliknij ikonę webhooka w nagłówku (widoczna dla adminów).
2. Kliknij „Dodaj webhook" i wpisz URL Twojego endpointu (musi być dostępny publicznie przez HTTPS).
3. Wybierz zdarzenia które chcesz obserwować.
4. Opcjonalnie ustaw sekret podpisu do weryfikacji żądań.
5. Kliknij „Dodaj" — webhook jest aktywny od razu.

Lista zdarzeń

Zdarzenie	Kiedy jest wysyłane
card.created	Utworzono nową kartę
card.updated	Zmieniono tytuł, opis, termin lub etykiety
card.moved	Karta przeniesiona do innej kolumny
card.assigned	Przypisano lub odpisano użytkownika
card.completed	Karta przeniesiona do kolumny „Gotowe"
card.deleted	Karta usunięta
comment.created	Dodano komentarz do karty
time_entry.created	Dodano wpis czasu pracy
member.joined	Użytkownik dołączył do tablicy
member.removed	Użytkownik usunięty z tablicy

Format payloadu

{
  "event": "card.moved",
  "timestamp": "2026-04-18T14:32:10Z",
  "board_id": "brd_01j9xk2m",
  "data": {
    "card_id": "crd_xyz123",
    "card_title": "Implementacja logowania",
    "from_column": "W trakcie",
    "to_column": "Gotowe",
    "moved_by": {
      "id": "usr_abc",
      "name": "Jan Kowalski"
    }
  }
}

Weryfikacja podpisu

Jeśli ustawiłeś sekret, każde żądanie zawiera nagłówek X-SimpleBoard-Signature z podpisem HMAC-SHA256:

const crypto = require('crypto');

function verifySignature(payload, secret, signature) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return `sha256=${expected}` === signature;
}

// W handlerze Express:
app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
  const sig = req.headers['x-simpleboard-signature'];
  if (!verifySignature(req.body, process.env.WEBHOOK_SECRET, sig)) {
    return res.status(401).send('Invalid signature');
  }
  const event = JSON.parse(req.body);
  console.log('Otrzymano zdarzenie:', event.event);
  res.sendStatus(200);
});

Cennik i płatności

Po rejestracji masz 30 dni bezpłatnego dostępu do wszystkich funkcji. Bez karty kredytowej. Po upływie trialu tablica przechodzi w tryb tylko do odczytu — dane są bezpieczne.

Plan	Cena	Rozliczenie
Miesięczny	1€ / użytkownik	Co miesiąc, anuluj kiedy chcesz
Roczny	10€ / użytkownik	Raz w roku (~17% taniej)

Anuluj w Ustawienia → Płatności w dowolnym momencie. Dostęp zachowasz do końca opłaconego okresu.

Pomoc i kontakt

• E-mail: hello@simpleboard.pl
• W aplikacji: przycisk „Pomoc" w prawym dolnym rogu