taubyte-resource-creation（taubyte 资源创建）

Resource Creation

Preconditions

• taubyte-core-constraints loaded
• taubyte-scope-routing completed
• taubyte-project-and-application completed for project (and application only if the task required it — do not assume an application exists)
• tau --json current was run after the last tau select project / tau new project; the Project field matches the task’s intended project (see taubyte-orchestrator → *New project hard gate* — never import or create resources under a stale selection)
• taubyte-context-log initialized
• taubyte-build-runtime-config available for server-side config/build logic

Order

• Global / project-level resources first (domain, and website / library only when taubyte-scope-routing keeps them at project scope) — no application step unless routing says otherwise.
• Full-stack multi-app (see taubyte-reference-index → *Full-stack worked example*): domain at project level → create/select Frontend → website there → create/select Backend → library, database, messaging (when using PubSub/WebSocket), functions there. Create messaging before or together with functions that publish or subscribe to that channel; create library / database before or in lockstep with function YAML that references them. Push project config and wait for config build success before relying on realtime or new routes.
• Website default: when taubyte-scope-routing → *Website when logically appropriate* applies, tau new website (and import/push per below) is in scope for that project — not optional for user-facing app briefs unless the user chose headless / API-only.
• Application-scoped resources next (database, storage, messaging, service, smartops, and function when scoped to an application) — run tau select application only for the phase that needs it; do not create an application for website-only or simple global function work.

Rules

• Use default non-interactive mode unless user requested interactive.
• For full flags, use taubyte-resource-flags-reference.
• Use MSYS_NO_PATHCONV=1 for path-like flags in Git Bash.
• Never use --generated-fqdn-prefix unless the user explicitly asks for a specific prefix value.
• If server-side config is needed, update .taubyte/config.yaml; if env vars are needed, declare them in .taubyte/build.sh only (see taubyte-build-runtime-config). Validate both before push.
• For Go function implementation correctness, apply taubyte-go-sdk-constraints.
• After creating a serverless function with --template empty, immediately edit empty.go at the function root (same directory as go.mod — never under lib/) with a real implementation. Do not create lib/, move empty.go into lib/, or add hand-written main.go; see taubyte-go-sdk-constraints (layout + Docker WASM test).
• Website/library creation must use explicit repo strategy; never rely on implicit repo auto-selection.
• Deterministic default for generated repos:

- website: tb_code_<project>_<website> - library: tb_code_<project>_<library>

• Immediately import after creation to sync local repository clone (only after preconditions above — especially correct Project in tau --json current):

- tau import website --name <site> - tau import library --name <lib>

• Immediately verify bound repo fullname/ID in config yaml after creation/import; if mismatch, stop and fix before any push.
• Update context log after every mutation.

One Go WASM library, multiple HTTP functions

When several routes share one build:

1. Create one library resource + repo (libraries/<name>.yaml, GitHub source).
2. Add separate functions/<handler>.yaml files under the same Backend (or chosen) application, each with source: libraries/<sameLibraryName> (path relative to that application).
3. Split behavior with trigger.type: https (or http per CLI), trigger.method, trigger.paths, and execution.call — each call must match a //export <call> symbol in the library sources. Pure PubSub consumers may omit domains:; HTTP routes keep domains: [...] as usual.
4. Define a database resource whose match (e.g. /leaderboard or appdata) is identical to the string passed to database.New(...) in the Go code (including a leading / when the YAML uses one). After editing YAML or Go, grep for database.New( and confirm every literal matches some **databases/*.yaml in the same application**.
5. For **libraries/*.yaml, set source.path to the path inside the library repository** where sources live (must match the cloned repo layout — not an invented folder). Mismatch is a common cause of “API runs but data doesn’t persist” or wrong handlers.

Verify each resource’s bound github.fullname after import/create. Multi-repo splits (config vs website vs library vs code skeleton) follow the same explicit-repo rules as any tau import website / tau import library workflow.

For a concrete YAML + repo layout, see taubyte-reference-index → *Full-stack worked example*.