Dokumentace — Tlycode

dashboard Přehled platformy

Tlycode je hosting platforma pro aplikace postavené na TypeScript-to-Lua-to-Rust architektuře. Administrace běží na adrese https://tlycode.ai a umožňuje kompletní správu projektů, prostředí, deploymentů a integrací s externími službami.

folder Projekty

Vytvářejte a spravujte projekty propojené s GitHub repozitáři.

layers Prostředí

Každý projekt může mít více prostředí (test, production) s vlastní konfigurací.

cloud_upload Deploy

Automatické nasazování z GitHub Actions nebo manuální deploy přes administraci.

dns Domény

Vlastní domény s automatickým SSL certifikátem a Cloudflare integrací.

database Databáze

PostgreSQL databáze přes Neon s automatickou správou a size limity.

smart_toy MCP

Model Context Protocol pro integraci s AI agenty (Claude Code, Cursor).

lightbulb Tip

Většinu operací můžete provádět také přes MCP connector přímo z AI agenta bez nutnosti otevírat webové rozhraní.

login Přihlášení a registrace

Přístup do administrace vyžaduje uživatelský účet. Platforma používá session-based autentizaci s cookies.

Registrace

Nový účet vytvoříte na stránce /hosting/register. Zadejte email, jméno a heslo. Po registraci budete automaticky přihlášeni.

Přihlášení

Přihlaste se na /hosting/login pomocí emailu a hesla. Session vyprší po 24 hodinách neaktivity.

info Bezpečnost

Hesla jsou uložena pomocí algoritmu Argon2. Session tokeny jsou ukládány v HttpOnly cookies a nejsou přístupné z JavaScriptu.

person Profil

Na stránce profilu (/hosting/profile) můžete:

Změnit jméno — aktualizujte své zobrazované jméno
Změnit heslo — zadejte stávající heslo a nové heslo pro aktualizaci

rocket_launch Setup projektu

Nový projekt v Tlycode můžete vytvořit dvěma způsoby — automaticky pomocí Claude AI agenta (MCP), nebo ručně přes webové rozhraní.

Předpoklady

Před vytvořením projektu je nutné propojit externí služby. Všechny mají free tier:

code GitHub

Propojení jedním klikem přes OAuth. Slouží pro uložení zdrojového kódu a automatický deploy.

cloud Google Cloud

Service Account s oprávněními pro Cloud Run a Cloud Storage. Nutné pro běh aplikací.

database Neon

API klíč pro PostgreSQL databáze. Free: 0.5 GB, 100 compute-hodin/měsíc.

shield Cloudflare

API token pro DNS správu a CDN. Free: DNS, CDN, DDoS ochrana.

mail Resend

API klíč pro odesílání emailů. Free: 3 000 emailů/měsíc, 1 doména.

Stav propojení můžete zkontrolovat na stránce /hosting/profile v sekci integrace.

smart_toy Setup s Claude agentem (MCP)

Nejrychlejší způsob. Claude agent provede kompletní setup za vás — stačí popsat, co chcete vytvořit.

lightbulb Jak to funguje

Claude agent používá MCP (Model Context Protocol) connector pro komunikaci s Tlycode API. Všechny operace provádí automaticky na základě vašich instrukcí.

mouse Ruční setup (webové rozhraní)

Pokud nepoužíváte AI agenta, můžete projekt vytvořit ručně krok za krokem přes administraci.

Srovnání

	S Claude agentem (MCP)	Ručně (web)
Čas setupu	~1 minuta	5–10 minuta
Počet kroků	1 (popište co chcete)	6–8 manuálních kroků
Potřebné znalosti	Žádné — agent vede	Základní orientace v administraci
Flexibilita	Agent se zeptá na všechna rozhodnutí	Plná kontrola nad každým krokem
Výsledek	Identický — projekt, repo, prostředí, DB, Cloud Run, deploy workflow

home Dashboard

Dashboard (/hosting/) je hlavní stránka po přihlášení. Zobrazuje přehled všech vašich projektů, jejich prostředí a poslední deploymenty.

Z dashboardu můžete:

Vytvořit nový projekt
Rychle přejít do detailu projektu nebo prostředí
Vidět stav posledních deploymentů
Přistoupit ke správě integrací (GitHub, Neon, Google Cloud, Cloudflare, Resend)

folder Správa projektů

Projekty jsou základní organizační jednotkou. Každý projekt je propojen s GitHub repozitářem a obsahuje jedno nebo více prostředí.

Vytvoření projektu

Klikněte na "Nový projekt" na dashboardu
Zadejte název projektu a volitelný popis
Vyberte nebo vytvořte GitHub repozitář (vyžaduje propojenou GitHub integraci)
Projekt se vytvoří s automaticky generovaným API secretem

Editace projektu

Na stránce editace projektu můžete změnit název, popis, připojit GitHub repozitář, regenerovat API secret, inicializovat projekt a spravovat prostředí.

API Secret

Každý projekt má unikátní 64-znakový hex API secret, který se používá pro autentizaci při automatických deploymentech z GitHub Actions.

warning Pozor

API secret uschovejte bezpečně. Kdokoli s tímto secretem může deployovat kód do vašeho prostředí.

Smazání projektu

Smazání projektu odstraní všechna prostředí, deploymenty, konfigurace a domény. Tato akce je nevratná.

layers Prostředí (Environments)

Každý projekt může mít více prostředí pro různé fáze vývoje. Prostředí mají vlastní konfiguraci, domény, databázi a deploymenty.

Typy prostředí

science Test

Testovací prostředí pro vývoj a testování. Cloud Run se konfiguruje s nižšími limity.

rocket_launch Production

Produkční prostředí s vyššími limity a optimalizací pro provoz.

Vytvoření prostředí

V detailu projektu klikněte na "Nové prostředí"
Zadejte název (např. "staging", "production")
Vyberte typ (test/production)
Volitelně nastavte GitHub branch

Detail prostředí

Na stránce detailu prostředí najdete přehled deploymentů, správu domén, konfiguraci, databázové připojení, Cloud Run služby a Cloud Storage buckety.

cloud_upload Deploymenty

Deploymenty představují nasazení kódu do prostředí. Každý deployment má stav, commit informace a volitelně log.

Stavy deploymentu

Stav	Popis
`pending`	Deployment byl vytvořen a čeká na zpracování
`in_progress`	Probíhá kompilace a nasazování
`success`	Deployment byl úspěšně nasazen
`failed`	Deployment selhal — zkontrolujte chybovou zprávu

Způsoby deploymentu

Automaticky (GitHub Actions) — push do nastavené branch spustí workflow
Manuálně z administrace — tlačítko "Deploy" v detailu prostředí
Přes API — POST /hosting/api/deploy s API secretem
Lokální deploy — POST /hosting/api/deploy/local

Rollout a smazání

Úspěšné deploymenty lze rolloutovat (aktivovat starší verzi) nebo smazat.

dns Domény

Každému prostředí lze přidat vlastní domény. Domény se ověřují přes DNS a mohou být spravovány přes Cloudflare integraci.

Přidání domény

V detailu prostředí klikněte na "Přidat doménu"
Zadejte název domény
Nastavte DNS záznamy podle instrukcí
Klikněte na "Ověřit" pro validaci DNS

Primární doména

Každé prostředí může mít jednu primární doménu, která se používá jako hlavní adresa aplikace.

DNS nastavení

Parametr	Popis	Výchozí
`domain`	Název domény	—
`is_primary`	Zda je doména primární	false
`dns_ttl`	Time-to-live pro DNS záznamy (v sekundách)	3600

settings Konfigurace (Environment Variables)

Každé prostředí má vlastní sadu konfiguračních proměnných a secretů. Tyto hodnoty jsou dostupné aplikaci za běhu.

Typy hodnot

visibility Běžná proměnná

Viditelná hodnota, např. APP_ENV=production.

visibility_off Secret

Skrytá hodnota, např. API klíče. Zobrazuje se jako ***.

database Databáze

Tlycode podporuje PostgreSQL databáze přes integraci s Neon (serverless PostgreSQL).

Možnosti připojení

add_circle Vytvořit novou

Vytvoří nový Neon projekt s databází. Automaticky nastaví připojení.

link Připojit existující

Vyberte existující Neon projekt a branch pro připojení.

warning Pozor

Smazání databáze je nevratné a odstraní všechna data. Pro dočasné odpojení použijte "Detach".

cloud Cloud Run

Cloud Run služby na Google Cloud Platform umožňují spouštět kontejnerizované aplikace. Každé prostředí může mít připojenou Cloud Run službu.

cloud_upload Cloud Storage

Google Cloud Storage buckety pro ukládání souborů, obrázků a dalších statických assetů. Každé prostředí může mít připojený jeden bucket.

code GitHub integrace

Propojení s GitHubem umožňuje automatické deploymenty, správu repozitářů a branch přímo z Tlycode.

database Neon integrace

Neon poskytuje serverless PostgreSQL databáze. Propojení umožňuje vytváření a správu databází přímo z Tlycode.

cloud Google Cloud integrace

Propojení s Google Cloud umožňuje správu Cloud Run služeb a Cloud Storage bucketů.

shield Cloudflare integrace

Cloudflare integrace umožňuje správu DNS záznamů, proxy nastavení a bezpečnosti přímo z Tlycode.

mail Resend integrace

Resend integrace umožňuje odesílání emailů přímo z Tlycode. Po propojení se API klíč automaticky přidá jako secret do nových prostředí.

Propojení

Vytvořte si účet na resend.com/signup
Přidejte a ověřte doménu přímo v Tlycode (na stránce prostředí v sekci Resend) nebo v Resend Dashboard → Domains (nastavte DNS záznamy)
Vytvořte API klíč v Resend Dashboard → API Keys (klíč začíná re_)
Na stránce projektu v Tlycode zadejte API klíč do sekce Resend a klikněte Propojit

Konfigurace prostředí

API klíč Resend se ukládá jako secret RESEND_API_KEY v konfiguraci prostředí:

Automaticky — při vytvoření nového prostředí (pokud je Resend propojený)
Ručně — tlačítkem RESEND_API_KEY secret na stránce prostředí

MCP

Nástroj	Popis
`resend_send_email`	Odeslání emailu (from, to, subject, html/text)
`resend_list_domains`	Výpis domén v Resend účtu
`resend_get_domain`	Detail konkrétní domény
`resend_add_domain`	Přidání email domény do prostředí
`resend_delete_domain`	Odebrání email domény z prostředí
`resend_verify_domain`	Ověření email domény v Resend

Limity free plánu

Parametr	Hodnota
Emailů / měsíc	3 000
Emailů / den	100
Vlastní domény	1

info Free tier

Free plán: 3 000 emailů/měsíc, 100 emailů/den, 1 vlastní doména. Pro vyšší limity zvažte placený plán na resend.com/pricing.

smart_toy MCP (Model Context Protocol)

Tlycode implementuje MCP server, který umožňuje AI agentům (Claude Code, Cursor, Windsurf) spravovat hosting přes přirozený jazyk.

lightbulb Tip

MCP connector umožňuje plnou automatizaci — AI agent může vytvořit projekt, připojit databázi, nakonfigurovat doménu, nasadit aplikaci a vrátit vám odkaz.