case study · aplikacja webowa

Gra planszowa od pierwszej karty do pliku w programie graficznym wydrukowanego prototypu

BoardForge to moje autorskie studio dla twórców gier planszowych i karcianych. W jednym miejscu projektuje się karty i plansze, prowadzi dane gry w tabeli, rozgrywa partię testową na wirtualnym stole i drukuje prototyp w domu. Bez znajomości grafiki, bez arkuszy pełnych wzorów i bez abonamentu.

Klient
Projekt autorski
Zakres
Projekt UX, frontend, silnik renderowania, backend, testy
Stack
React · TypeScript · FastAPI · Playwright
Języki
polski, angielski
Studio kart BoardForge: lista warstw szablonu, karta jednostki na płótnie z zaznaczonym tytułem, panel właściwości z informacją, że zmiana obejmie 76 kart, i pasek przykładowych kart na dole
Studio kart w trybie edycji szablonu. Pasek na dole od razu pokazuje efekt zmiany na kartach tego typu, także na tej z najdłuższą nazwą.

01 / punkt wyjścia

Prototyp gry rozjeżdża się między grafiką, arkuszem i drukarką

Typowy prototyp to program graficzny do wyglądu kart, arkusz kalkulacyjny do statystyk i nożyczki. Każda poprawka balansu oznacza ręczne przerabianie kart, a test przy stole wymaga nowego wydruku. BoardForge łączy te kroki w jedną aplikację dla początkujących twórców, projektantów gier z setkami kart, autorów print & play i grup testerów.

  1. 01Wygląd osobno, dane osobno

    Zmiana jednej statystyki to ręczna poprawka w pliku graficznym. Przy setkach kart łatwo o rozjazd między tabelą a tym, co trafia na stół.

  2. 02Ekran to nie papier

    Za mały tekst, napis przy linii cięcia albo rozmyta grafika wychodzą dopiero po wydruku, czyli po zużyciu tuszu i czasu.

  3. 03Ręczne wyjątki giną

    Gdy zmienia się wzór karty, poprawki naniesione na pojedyncze karty znikają po cichu albo blokują zmianę całej talii.

  4. 04Test wymaga wycinania

    Żeby sprawdzić, czy gra działa, trzeba ją wydrukować i pociąć. Uwagi z partii lądują na kartkach, a nie na liście poprawek.

  5. 05Bariera wejścia

    Pomysł na grę nie powinien wymagać umiejętności grafika ani programisty. Pierwszy działający prototyp ma powstać tego samego wieczoru.

  6. 06Praca nie może przepaść

    Projekt gry to miesiące pracy. Zapis ma się dziać sam, każda zmiana ma dać się cofnąć, a pliki mają należeć do autora, nie do usługi.

02 / wskaźniki

Pełna gra karciana w jednym projekcie

Liczby z projektu testowego: gra karciana Vera Discordia przeniesiona do BoardForge, odczytane z pulpitu gry, studia kart i kreatora druku w działającej aplikacji (listopad 2026).

201
elementów gry w galerii, każda miniatura rysowana na żywo
462
sztuki w pudełku policzone z talii i zestawów
76
kart z jednego szablonu: jedna zmiana obejmuje wszystkie
96str.
PDF do druku: 48 kartek z rewersami pod druk dwustronny
19
talii i zestawów opisujących zawartość pudełka
5
szablonów kart i elementów w projekcie
27
kart z brakującym tłumaczeniem wykrytych automatycznie na pulpicie
2
wersje językowe gry, PL i EN, z jednego projektu

03 / architektura

Wzór, dane i ręczna poprawka składają się w jedną kartę

Każda karta powstaje z warstw informacji. Dzięki temu rzecz poprawia się raz, w jednym miejscu, a ręczne wyjątki nigdy nie znikają po cichu.

boardforge / karta
Edycja pojedynczej karty: karta z ilustracją i czterema tarczami, po prawej panel z polami nazwy, grafiki, rangi, statystyk i zdolności, na dole pasek kart z talii
Edycja karty. Po prawej pola zdefiniowane we wzorze, na dole cała talia. Skrót Alt+←/→ przełącza karty bez wychodzenia z edytora.

Zawsze wiadomo, co się zmienia

Aplikacja rozróżnia trzy poziomy: szablon wszystkich kart, jedną kartę i jej pojedynczy egzemplarz. Indygo oznacza pracę na wzorze, bursztyn zmianę tylko na jednej karcie, a komunikat mówi wprost, ile kart obejmie edycja.

Ten sam wygląd na ekranie i na papierze

Karty i plansze rysuje własny silnik SVG w przeglądarce, więc zmianę widać od razu. Ten sam renderer zasila edytor, stół do testów i PDF, a automatyczny test w Playwright porównuje obie wersje karty piksel po pikselu.

Pisanie bezpośrednio na karcie

Warstwy przeciąga się jak w programie graficznym, a tekst wpisuje na płótnie. Ikony w tekście, rzędy kości i symboli oraz kadrowanie ilustracji działają bez osobnego narzędzia.

04 / dane gry

Balans na liczbach, a nie na pojedynczych kartach

Tabela działa jak arkusz kalkulacyjny: zaznaczenie zakresu, wklejanie, wypełnianie w dół. Karty zmieniają się razem z nią, a pulpit gry podpowiada, co jeszcze wymaga uwagi.

05 / plansze i testy

Partia testowa, zanim cokolwiek zostanie wycięte

Plansza nie jest tylko obrazkiem. Aplikacja wie, które pola się stykają i jakiego są typu, a z tej wiedzy korzysta stół do testów.

Studio plansz siatki · heksy · tory · kafle modułowe

boardforge / plansza
Studio plansz: plansza z siatką kwadratów, polem heksów, torem i obszarem, paleta typów pól oraz panel druku z podziałem na arkusze A4
Studio plansz. Siatka, heksy i tor na jednej planszy, typy pól (las, góry, rzeka, start) malowane pędzlem. Po prawej podział dużej planszy na arkusze A4 z zakładkami do sklejenia i mapą złożenia.

Wirtualny stół ręce graczy · tury i fazy · cofanie ruchów

boardforge / stół
Wirtualny stół: karty rozłożone na zielonym filcu, pasek tury z rundą i aktywnym graczem, panel pudełka z liczbą sztuk każdej karty i ręce dwóch graczy na dole
Stół do testów. Panel „Pudełko” pilnuje liczby sztuk, na dole ręce graczy, u góry tura i cofanie.

Gra taka, jaka jest teraz

Stół ładuje aktualny stan projektu. Rozdawanie kart, rzuty kośćmi, pionki i punkty działają bez eksportu i bez wydruku.

Asystent zasad

Podpowiada, co powinno się wydarzyć, np. „wejście na las: dobierz kartę wydarzenia”. Korzysta z typów pól i sąsiedztwa zapisanych na planszy.

Uwagi prosto na listę poprawek

Notatka z partii trafia do dziennika testów jako zadanie. Odhacza się ją po wydaniu poprawionej wersji gry. Partię można też rozegrać przez sieć (każdy widzi tylko swoje karty) albo wyeksportować do Tabletop Simulatora.

06 / druk

Prototyp z domowej drukarki, razem z instrukcją

Kreator druku pyta o trzy rzeczy: co drukujesz, na jakim papierze i jak. Przed pobraniem widać każdą stronę PDF z awersami i rewersami ułożonymi pod druk dwustronny.

Druk w domu

  • Spad, znaczniki i linie cięcia, także dla ploterów tnących
  • Druk tylko kart zmienionych od ostatniej wersji
  • Wydruk szkicowy oszczędzający tusz

Kontrola przed drukiem

  • Za mały tekst i za słaby kontrast
  • Rozmyte grafiki i napisy przy linii cięcia
  • Podgląd oczami osób z daltonizmem

Eksport

  • Pojedyncze karty do PNG i SVG
  • Dane do CSV
  • Cała gra jako paczka ZIP i do Tabletop Simulatora

07 / niezawodność

Nic nie przepada, a pliki należą do autora

Narzędzie do pracy na miesiące musi wybaczać błędy i nie zamykać danych w swoim formacie.

zapis

Autozapis, także bez internetu

Zapis działa w tle. Gdy połączenie zniknie, zmiany czekają w przeglądarce i zapisują się, gdy wróci.

historia

Wersje, porównanie i kosz

Wersje zapisują się same. Dwie wersje można porównać i przywrócić całą grę albo pojedynczą kartę. Usunięte rzeczy trafiają do kosza.

format

Gra to zwykły katalog plików

Dane i grafiki w otwartym formacie. Projekt można skopiować, zarchiwizować albo wysłać jako jedną paczkę ZIP.

import

Gotowa gra print & play z PDF

Import istniejącej gry z PDF, z porównaniem każdej karty z oryginalnym skanem. Karty z niepewnym odczytem trafiają na listę do sprawdzenia.

08 / co dalej

Funkcje zaprojektowane i czekające na wdrożenie

BoardForge rozwija się dalej. Trzy pierwsze pozycje są w trakcie wdrożenia, trzy kolejne w planach.

  1. wkrótceWygląd „Kuźnia”Spokojny interfejs w grafice i bursztynie, z paskiem ikon, pływającymi panelami i jasnym wariantem.
  2. wkrótceWersja w przeglądarceKonto online i start bez instalacji, z eksportem do otwartej paczki.
  3. wkrótceAplikacja na komputerInstalacja jednym plikiem do pracy całkowicie offline.
  4. w planachSędzia na stoleStół, który zna zasady gry i zatrzymuje ruchy niezgodne z regułami.
  5. w planachSymulacja partiiTysiące automatycznych rozgrywek, które pokażą zbyt silną kartę lub strategię.
  6. w planachImport do warstwRozkładanie gotowej gry z PDF na edytowalny tekst, ilustracje i statystyki.

technologie

  • React
  • TypeScript
  • Vite
  • Własny renderer SVG
  • Python
  • FastAPI
  • Playwright
  • Docker

Projekt autorski. Zrzuty ekranu z działającej aplikacji, listopad 2026. Na zrzutach karty z gry Vera Discordia, używanej jako projekt testowy: © Aitor González Guridi i przyjaciele, licencja CC BY-NC-ND, ilustracje należą do ich autorów. Liczby w sekcji 02 opisują ten projekt testowy.

następny krok

Masz podobne wyzwanie?

Opisz, co chcesz osiągnąć. Wrócę z konkretną propozycją, wyceną i planem wdrożenia.