railway-templates

# Railway Templates Search and deploy services from Railway's template marketplace. ## When to Use - User asks to "add Postgres", "add Redis", "add a database" - User asks to "add Ghost", "add Strapi", "add n8n", or any other service - User wants to find templates for a use case (e.g., "CMS", "storage", "monitoring") - User asks "what templates are available?" - User wants to deploy a pre-configured service ## Common Template Codes | Category | Template | Code | |----------|----------|------| | **Databases** | PostgreSQL | `postgres` | | | Redis | `redis` | | | MySQL | `mysql` | | | MongoDB | `mongodb` | | **CMS** | Ghost | `ghost` | | | Strapi | `strapi` | | **Storage** | Minio | `minio` | | **Automation** | n8n | `n8n` | | **Monitoring** | Uptime Kuma | `uptime-kuma` | For other templates, use the search query below. ## Prerequisites Get project context: ```bash railway status --json ``` Extract: - `id` - project ID - `environments.edges[0].node.id` - environment ID Get workspace ID: ```bash bash <<'SCRIPT' ${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \ 'query getWorkspace($projectId: String!) { project(id: $projectId) { workspaceId } }' \ '{"projectId": "PROJECT_ID"}' SCRIPT ``` ## Search Templates List available templates with optional filters: ```bash bash <<'SCRIPT' ${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \ 'query templates($first: Int, $verified: Boolean) { templates(first: $first, verified: $verified) { edges { node { name code description category } } } }' \ '{"first": 20, "verified": true}' SCRIPT ``` ### Arguments | Argument | Type | Description | |----------|------|-------------| | `first` | Int | Number of results (max ~100) | | `verified` | Boolean | Only verified templates | | `recommended` | Boolean | Only recommended templates | ### Rate Limit 10 requests per minute. Don't spam searches. ## Get Template Details Fetch a specific template by code: ```bash bash <<'SCRIPT' ${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \ 'query template($code: String!) { template(code: $code) { id name description serializedConfig } }' \ '{"code": "postgres"}' SCRIPT ``` Returns: - `id` - template ID (needed for deployment) - `serializedConfig` - service configuration (needed for deployment) ## Deploy Template ### Step 1: Fetch Template ```bash bash <<'SCRIPT' ${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \ 'query template($code: String!) { template(code: $code) { id serializedConfig } }' \ '{"code": "postgres"}' SCRIPT ``` ### Step 2: Deploy to Project ```bash bash <<'SCRIPT' ${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \ 'mutation deployTemplate($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }' \ '{ "input": { "templateId": "TEMPLATE_ID_FROM_STEP_1", "serializedConfig": SERIALIZED_CONFIG_FROM_STEP_1, "projectId": "PROJECT_ID", "environmentId": "ENVIRONMENT_ID", "workspaceId": "WORKSPACE_ID" } }' SCRIPT ``` **Important:** `serializedConfig` is the exact JSON object from the template query, not a string. ## Composability - **Connect services**: Use railway-environment skill to add variable references - **View deployed service**: Use railway-service skill - **Check logs**: Use railway-deployment skill - **Add domains**: Use railway-domain skill