HTML/CSS to Image Pulumi provider

Manage HTML/CSS to Image resources with TypeScript, Python, Go, C#, Java, or Pulumi YAML.

Website · Documentation · Management API · API reference

Create images and reusable templates alongside application API keys, proxies, storage destinations, and Open Graph configurations. The provider shares its implementation with the Terraform provider.

Installation

Install the SDK for your Pulumi project's language:

For Java, add this Maven dependency:

<dependency>
  <groupId>com.htmlcsstoimage</groupId>
  <artifactId>pulumi</artifactId>
  <version>0.1.2</version>
</dependency>

The SDK automatically downloads the matching provider plugin from GitHub Releases. YAML programs select the plugin directly, as shown below.

Example

In a Python Pulumi project, install pulumi-html-css-to-image and configure your credentials:

pulumi config set html-css-to-image:apiId YOUR_API_ID
pulumi config set --secret html-css-to-image:apiKey

Add this to __main__.py:

import pulumi
import pulumi_html_css_to_image as hcti

card = hcti.ImageHtmlCss(
    "card",
    html="<h1>Hello from Pulumi</h1>",
    css="h1 { font-family: Inter; padding: 48px; }",
    google_fonts=["Inter"],
)

pulumi.export("imageUrl", card.image_url)

Run pulumi preview and pulumi up. Open the returned URL to render the image. Creation and refresh read/save metadata without rendering bytes. Input changes replace image definitions; template edits create new versions under a stable ID.

Configuration

The key needs the read/write/delete permissions for the resources you manage. Credentials and headers retain Pulumi secret markings. Version identifiers are decimal strings to preserve all int64 digits. Requests identify themselves with HCTIGo/<sdk-version> HCTIPulumi/<provider-version>.

Resources and lookups

• Proxy, ApiKey, OgConfig, and StorageDestination.
• Template, ImageHtmlCss, ImageUrl, and ImageTemplated.
• getTemplate: latest or pinned template settings.
• getTemplateVersions: newest-first history with automatic pagination and a default limit of 1000.
• getAwsStorageExternalId: external ID and writer role ARN for an AWS trust policy.

See examples for complete YAML programs. In .NET, the API key secret is ApiKey.Value and the URL image operation URL is ImageUrl.RenderingUrl to avoid member/type name collisions.

Contributing

See development and releasing. API lifecycle behavior belongs in the Terraform provider; this repository maintains the bridge, exact version conversions, SDK metadata, and Pulumi examples.

HTML/CSS to Image · Documentation · Management API · Pulumi provider repository · Report an issue