raw-app

Raw App to umiejętność Windmill do tworzenia aplikacji frontendowych na zamówienie. Wybierz React, Svelte lub Vue i połącz je z backendem Windmill — funkcjami, skryptami i tabelami danych. Struktura projektu zawiera wszystko: konfigurację aplikacji, definicje typów backendu, skrypty serwerowe oraz migracje SQL. Idealne do budowania zaawansowanych interfejsów użytkownika bez ograniczeń wizualnych.

1. Uruchom polecenie wmill app new w terminalu. Zostaniesz poproszony o wybranie frameworka frontendowego — React, Svelte lub Vue — oraz o podanie nazwy aplikacji.

2. Po utworzeniu projektu przejrzyj strukturę folderów. Plik raw_app.yaml zawiera konfigurację aplikacji, index.tsx (lub odpowiednik dla wybranego frameworka) to punkt wejścia frontendowy, a folder backend/ to miejsce na skrypty serwerowe.

3. Dodaj backend runnable — skrypt serwerowy — tworząc plik w folderze backend/. Obsługiwane są TypeScript (.ts), Python (.py), Go (.go) i inne języki. Nazwa pliku bez rozszerzenia staje się ID funkcji, którą możesz wywoływać z frontendu.

4. Jeśli używasz bazy danych, umieść migracje SQL w folderze sql_to_apply/ — będą stosowane przez serwer deweloperski. Uruchom wmill app generate-agents aby odświeżyć schematy bazy danych w pliku DATATABLES.md.

5. W komponencie frontendowym importuj auto-generowane definicje typów z pliku wmill.ts — zawierają one sygnatury wszystkich backendowych runnable'i. Wywoływaj funkcje backendu bezpośrednio z kodu frontendowego.

6. Uruchom serwer deweloperski poleceniem wmill app dev aby testować aplikację lokalnie. Po ukończeniu wdróż aplikację do Windmill.