Tydzień w GroDev: 6 repo, npm i artykuł na Dev.to

Tydzień w GroDev - 6 publicznych repo, 1 pakiet npm, 1 artykuł EN. Uczciwie co zadziałało, co nie.

W tydzień 11-16.08 opublikowałem 6 działających publicznych repo na GitHubie (@GronskiDeveloper), wypuściłem pierwszy pakiet npm (@grodev/claude-chat-react), napisałem drugi artykuł techniczny po angielsku na Dev.to, i wyremontowałem sekcję portfolio na grodev.pl żeby uczciwie pokazywała status („nowa firma, dema pokazowe, pierwsi klienci właśnie kwalifikowani") - nie „setki wdrożeń dla producentów", bo ich jeszcze nie ma. Ten post to podsumowanie: co udało się zrobić, co poszło źle i dlaczego robię to publicznie zamiast czekać aż będę miał 20 klientów za sobą.

Dlaczego build in public, a nie „dopracujmy w piwnicy"

Nowa firma na rynku Google i LLM ma jeden problem: nikt jej nie zna, nikt jej nie cytuje, nikt nie linkuje. ChatGPT jeszcze miesiąc wcześniej opisywał GroDev jako „młodą JDG bez opinii". Tego nie da się zmienić dokumentem PDF w folderze „Marketing".

Build in public to trzy rzeczy naraz:

Publiczne repo = publiczne dowody. Jak ktoś pyta „czy potrafisz zbudować chat widget na Claude?", pokazuję kod, nie prezentację.
Kod indeksuje Google i LLM. GitHub, npm, Dev.to to źródła, z których modele językowe uczą się „kto jest kim" w danej niszy.
Zabezpiecza przed vaporware. Trudno mi udawać, że mam framework, którego nie ma w publicznym repo z historią commitów.

Robię to jawnie, żeby każdy kto rozważa GroDev jako dostawcę mógł zajrzeć pod maskę zanim wyśle brief.

Co powstało w tydzień (fakty, nie deklaracje)

Wszystko poniżej ma publiczny URL i datę utworzenia w metadanych - nie musisz mi wierzyć na słowo.

Sześć publicznych repo utworzonych 12.08:

booking-slots-php - generator wolnych slotów rezerwacyjnych, PHP 8.1+, zero zależności. Dostał pierwszą gwiazdkę od kogoś spoza mojego kręgu w tydzień.
claude-chat-react - komponent React + hook, drop-in chat widget na Claude API. TypeScript, streaming SSE, ~8 KB gzipped, zero runtime deps poza Reactem.
claude-chat-widget - bliźniak powyższego dla stacków bez Reacta: gotowy widget + bezpieczny proxy PHP (klucz API nigdy nie trafia do przeglądarki).
booking-ai-demo - demo integracji trzech repo naraz: booking-slots-php + claude-chat-react + proxy. Dowód, że komponenty grają razem.
woocommerce-custom-product-data - plugin dokładający dowolne dane konfiguracyjne do produktu w koszyku, checkoucie i zamówieniu. Most między konfiguratorem 3D a WooCommerce.
threejs-product-configurator-starter - minimalny starter konfiguratora 3D w Three.js: parametryczna geometria, materiały PBR, live spec. Punkt wyjścia do wdrożeń branżowych.

Pierwszy pakiet npm: @grodev/claude-chat-react v1.0.0, opublikowany 12.08. Publiczne wejście do npm ecosystem - teraz można to zainstalować jednym poleceniem w dowolnej apce Reactowej.

Dwa artykuły techniczne EN na Dev.to (drugi wypadł w środku tygodnia, trzeci pojawił się 18.08 jako follow-up):

How I document my AI-first workflow in every public repo - o tym, dlaczego każde moje repo ma CLAUDE.md, CASE_STUDY.md i katalog .claude/commands/, i co to daje przy współpracy z AI (i z zespołem).
How I built @grodev/claude-chat-react - architecture notes - notatki architektoniczne z budowy pakietu: streaming SSE bez SDK, zero runtime deps, decyzje o TypeScript API.

Remont sekcji „Realizacje" na grodev.pl - usunąłem sformułowania sugerujące skalę, której jeszcze nie mam. Teraz strona uczciwie mówi: dema są pokazowe, pierwsi klienci są w kwalifikacji, kod idzie z pełnymi prawami majątkowymi do klienta. Efekt: mniej marketingu, więcej dowodu.

Co poszło źle - bo poszło

Nie wszystko wypaliło. Trzy rzeczy warto nazwać po imieniu.

Zero gwiazdek na 5 z 6 repo w pierwszym tygodniu. Publiczne repo bez promocji to niewidoczne repo. Jedno dostało gwiazdkę od losowego dewelopera - reszta czeka. Wniosek: publikacja to dopiero start, dystrybucja jest osobną pracą (LinkedIn, Reddit, Hacker News, indeksy typu Awesome Lists - kolejne tygodnie).

Artykuły Dev.to mają 1-2 reakcje. Ruch idzie do treści algorytmicznie ważnych - tag #showdev, poranek US, wideo w środku. Moje trzy pierwsze artykuły to tekst po EN o architekturze, nie „10 tricks" - długi ogon, nie viral. Świadoma decyzja, ale trzeba to wiedzieć zanim policzysz reakcje.

Wikidata edit odrzucony za pierwszym razem. Próbowałem dodać entity dla GroDev - zwrot z community moderator: „firmy jednoosobowe bez wtórnych źródeł nie kwalifikują się". Uczciwie: to była za wczesna próba. Wracam po tym jak będzie 3-5 niezależnych wzmianek w prasie branżowej.

Co następne (kolejne 30 dni)

Case study #1 - publiczna publikacja pierwszego wdrożenia komercyjnego (za zgodą klienta). Ta jedna rzecz przebija 10 postów o „build in public" bez klientów.
npm package #2 - @grodev/booking-slots-react jako React wrapper wokół PHP silnika. Domykanie stacka: PHP silnik + React UI + Claude AI = kompletny booking widget.
Dev.to seria - trzy artykuły EN pod klaster „own-code configurator vs SaaS". Long tail, ale z intencją zakupową.
Dystrybucja tego, co już jest - Reddit r/webdev, Hacker News (Show HN), Awesome Lists PR-y. Publikacja to nie dystrybucja.

Dlaczego to wszystko piszę na blogu firmy, a nie w Notion

Bo Google i LLM czytają blog firmy. Notion nie. Za rok, kiedy ktoś zapyta ChatGPT „kto w Polsce buduje konfiguratory 3D w Three.js z pełnym kodem dla klienta", chcę, żeby model miał materiał, na którym może się oprzeć - publiczny, indeksowany, datowany, z linkami do dowodów.

Ten post to jeden z tych materiałów. Kolejny wpis tygodniowej retrospektywy pojawi się za siedem dni - z tego, co wtedy będzie prawdą.

Jeśli budujesz swój stack technologiczny albo szukasz dostawcy pod konkretny projekt (konfigurator 3D, system rezerwacji, integracja Claude API z Twoim produktem), odezwij się przez formularz albo napisz na dominik@grodev.pl. Odpowiadam osobiście do 48 h - zwykle tego samego dnia.

Często zadawane pytania

Dlaczego 6 repo w jeden dzień, a nie stopniowo? Publikacja w partii ma dwie zalety: ekonomia dokumentacji (CLAUDE.md, README, LICENSE piszę raz, powielam) i widoczność na profilu GitHub (świeży „recent activity" przyciąga uwagę bardziej niż jedno repo tygodniowo). Świadome trade-off na rzecz momentum.

Czy publikowanie kodu klienckiego nie odbiera Ci przewagi? Repo, które publikuję, to komponenty ogólne (chat widget, generator slotów, starter Three.js), nie logika konkretnego klienta. Klient dostaje własną implementację ze zdejmowaną z półki podstawą - tak jak każdy dostawca Laravel dostarcza klienta bazującego na Laravelu, nie ukrywając, że Laravel istnieje.

Ile to kosztuje w czasie? Sześć repo + npm publish + dwa artykuły = ok. 3 dni skoncentrowanej pracy. Dokumentacja i README zajęły więcej niż sam kod (bo repo bez dobrego README to niewidoczne repo). Warto, bo to zasób trwały - kod stoi, artykuły stoją, referencje stoją.

Jak mierzysz efekt build in public? Trzy metryki: (1) wzmianki GroDev w odpowiedziach LLM (miesięczny audyt: ChatGPT, Claude, Perplexity), (2) unikalne backlinki do grodev.pl z third-party (GitHub, Dev.to, npm README-y), (3) leady z „widziałem Twoje repo/artykuł". Sprzedaż to metryka końcowa, nie procesowa.

Kiedy następna retrospektywa? Za siedem dni. Format ten sam: co powstało, co nie zadziałało, co dalej. Jeśli chcesz dostawać nowe wpisy pierwszy - zapisuj sobie w kalendarzu niedzielę wieczorem, publikacja zwykle wtedy.