CtrlK
BlogDocsLog inGet started
Tessl Logo

putio/frontend-repos

Structure frontend repositories around a shared verify and delivery model. Use when standardizing package repos, app repos, or SDK repos across TypeScript, Swift, Kotlin, or similar ecosystems; setting up CI guardrails; defining a repo-local verify command; or enabling continuous publish or deploy flows on main after verify passes.

97

Quality

97%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

applications.mdreferences/

Application Repo Defaults

Use this when the repo is an application rather than a published package.

Core Model

  • Keep the same VERIFY first rule as package repos.
  • Treat deploys as the app equivalent of package publishing.
  • Prefer one repo-local deploy command per delivery target, such as deploy-preview, deploy-beta, or deploy-production.
  • Run deploy jobs from GitHub Actions after VERIFY passes.

Expected Shape

  • one repo-local verify entrypoint
  • one CI verify job that runs it on pull requests and main pushes
  • one or more deploy jobs gated on verify
  • a deterministic promotion signal, usually pushes or tags on main
  • no manual checklist-driven deploy flow unless the platform truly requires it

Delivery Targets

  • Web apps: preview or production hosting
  • Native apps: TestFlight, beta tracks, or store delivery
  • Internal apps or tools: staging or production environments

Guardrails

  • Keep deploy logic behind local commands so workflow YAML stays thin.
  • Use the smallest set of secrets and permissions required for each deploy target.
  • Prefer continuous beta or preview delivery by default, with stricter promotion gates only where the product or platform requires them.
  • If the repo has multiple delivery targets, keep their commands explicit instead of overloading one generic deploy.

references

applications.md

delivery-model.md

env-setup.md

typescript.md

SKILL.md

tile.json