Pactown.com: Kompletny Przewodnik po Funkcjonalnościach — 2026

Aktualna wersja: 0.1.8
Ostatnia aktualizacja: 10 lutego 2026

Pactown.com to platforma executable documentation — Twój README.md staje się działającą aplikacją pod publicznym URL. Poniżej znajdziesz kompletny opis wszystkich dostępnych funkcji.

---

Spis Treści

1. Executable Documentation
2. AI / LLM Integration
3. Edytor Markdown (TipTap)
4. Desktop & Mobile Builds
5. Deployment & Infrastruktura
6. Autentykacja
7. Płatności
8. Internationalization (i18n)
9. Marketplace / Examples
10. Program Poleceń
11. Diagnostyka & Monitoring
12. Security
13. Self-Hosted

---

Executable Documentation

Pactown zamienia dokumentację w działające aplikacje:

• Markdown as Infrastructure — README.md definiuje środowisko, zależności i kod
• Markpact format — standardowy format markpact:deps, markpact:file, markpact:run
• Zero-config deployment — automatyczny setup z dokumentacji
• Publiczny URL + SSL — każde demo pod [app]-[username].pactown.com
• Konfigurowalny separator — . lub - między app a username

Obsługiwane Języki i Frameworki

---

AI / LLM Integration

Pactown integruje się z modelami LLM przez OpenRouter:

• Generowanie projektów — opisz co chcesz, AI wygeneruje kompletny markpact
• Auto-fix błędów — automatyczne naprawianie błędów runtime z diff preview
• Chat z kontekstem — konwersacyjny AI z pełnym kontekstem projektu
• Wybór modelu — możliwość wyboru modelu LLM (w tym darmowe modele jak nemotron)
• Fix proposals — propozycje napraw z podglądem zmian

---

Edytor Markdown (TipTap)

Wbudowany edytor WYSIWYG oparty o TipTap:

• Edycja wizualna z podglądem na żywo
• Code blocks z syntax highlighting
• Obsługa markpact:* codeblocków
• Live preview generowanej aplikacji
• Eksport do czystego Markdown

---

Desktop & Mobile Builds

Od wersji 0.1.x Pactown obsługuje budowanie natywnych aplikacji:

Desktop (4 frameworki)

Mobile (4 frameworki)

Dodatkowe Funkcje Buildów

• Linux AppImage fix — automatyczny patch --no-sandbox + generowanie run.sh
• Retencja buildów — max 3 najnowsze buildy per scope, starsze automatycznie usuwane
• Download z UI — pobieranie artefaktów bezpośrednio z panelu przykładów
• Web Preview — aplikacje desktop/mobile w przeglądarce na serwerach headless

---

Deployment & Infrastruktura

Podman Quadlet

Pactown wykorzystuje Podman Quadlet — systemd-native container orchestration:

• Rootless containers — bez demona, per-user namespaces
• Systemd integration — natywne zarządzanie usługami
• Auto-restart — via systemd
• Zero memory footprint — kontenery on-demand

Infrastructure as Code (IaC)

Każdy sandbox generuje:

• pactown.sandbox.yaml — specyfikacja runtime
• Dockerfile — gotowy do produkcji
• docker-compose.yaml — single-service compose

Traefik

• Wildcard SSL (Let's Encrypt)
• Automatyczny routing subdomen
• Health checks

SSE Real-time Status

Dashboard korzysta z Server-Sent Events (GET /runner/status/stream) zamiast pollingu — natychmiastowe aktualizacje statusu.

---

Autentykacja

Pactown obsługuje wiele providerów autentykacji:

• access_token jako httpOnly cookie (nie w localStorage)
• admin_token jako httpOnly cookie

---

Płatności

Cennik

---

Internationalization (i18n)

Interfejs platformy dostępny w 7 językach:

• Automatyczne wykrywanie locale przeglądarki
• Przełącznik języka w nawigacji
• Lokalizacja UI, komunikatów i dokumentacji

---

Marketplace / Examples

Pactown oferuje DB-backed marketplace z gotowymi przykładami:

• 20+ przykładów w różnych kategoriach
• Kategorie i tagi — filtrowanie i wyszukiwanie
• Build z przykładu — budowanie desktop/mobile app bezpośrednio z marketplace
• Licznik pobrań — popularność przykładów
• Publiczne API — GET /public/examples, GET /public/examples/{slug}

Przykładowe Kategorie

• Todo apps, Chat boty, API gateways
• Webhook inspectors, CSV/JSON tools
• SVG generators, SQLite UI
• I wiele więcej...

---

Program Poleceń

System referrali dla użytkowników Pactown:

• Unikalne linki — każdy użytkownik ma swój link polecający
• Śledzenie — rejestracje i aktywność poleconych
• Punkty — zbieranie punktów za polecenia
• Wypłata — od 100 PLN, netto + VAT na fakturę

---

Diagnostyka & Monitoring

• Synchronizacja stanu UI z URL — parametry view, project, terminal, terminal_tab, settings
• Trace — ślad działań użytkownika jako token trace + trace_id
• Zgłoś problem — modal z możliwością dołączenia zrzutu ekranu (JPEG, max 1280px)
• Activity log — backend zapisuje zgłoszenia z metadanymi
• Loki + Promtail + Grafana — stack logów w docker-compose

---

Security

Rootless Containers

• Podman Quadlet z per-user namespaces
• Brak shared daemon (w przeciwieństwie do Docker)

Sanitization (33 funkcje)

• sanitize_name — ochrona przed injection w nazwach kontenerów
• sanitize_env_value — escape zmiennych środowiskowych
• sanitize_domain — walidacja domen dla Traefik
• validate_volume — blokowanie niebezpiecznych mount paths
• check_dangerous_content — wykrywanie niebezpiecznych wzorców

Testy Bezpieczeństwa

• 24+ testów w test_quadlet_security.py
• Container name injection, environment variable injection
• Volume mount injection, Traefik label injection
• Systemd unit injection, tenant isolation

---

Self-Hosted

Pactown jest w pełni open source i może być hostowany na własnym serwerze:

Wymagania

• VPS: 8GB RAM, 8 vCPU (np. Hetzner CX31 ~€17/msc)
• OS: Ubuntu 22.04/24.04 lub Fedora 39+
• Domena: z wildcard DNS (*.twoja-domena.com)

Quick Start

git clone https://github.com/wronai/pactown-com.git
cd pactown-com
make config
make install
make quadlet-init
make up

Korzyści Self-Hosted

• Pełna kontrola nad danymi (GDPR, HIPAA)
• Brak vendor lock-in
• Unlimited użytkowników i demo
• Customization i white-labeling

---

Linki

• Platforma: pactown.com
• GitHub (platforma): github.com/wronai/pactown-com
• GitHub (CLI): github.com/wronai/pactown
• Przykłady: pactown.com/examples
• Blog: pactown.com/blog

---

Zobacz też

• Pactown 0.1.8 Release Notes
• Pactown MVP: Status Projektu
• Pactown vs StackBlitz
• Pactown vs CodeSandbox
• Pactown vs Replit

---

Ostatnia aktualizacja: 10 lutego 2026