Package {shinyseo}

Generate missing visual assets with a user-supplied LLM or image API

Description

Looks for missing favicon, Apple touch icon, and share image fields in meta and asks a caller-supplied generator function to create them. shinyseo does not call any image-generation service itself – generator is the caller's own function, written against whatever LLM or image-generation API they already have access to (OpenAI, Adobe Firefly, a local model, and so on). This keeps the package free of any particular vendor's dependencies, API keys, formats, or running costs – the caller's function is the only thing that needs to know which service it is talking to.

Usage

generate_assets(
  meta,
  generator,
  path = "www",
  assets = c("favicon", "apple_touch_icon", "image")
)

Arguments

Value

The updated meta list, with newly generated fields set to paths under path (e.g. "/favicon.png"). Fields already present in meta are left untouched. Write the result back with yaml::write_yaml() to persist it.

Interactively create a metadata YAML file

Description

Walks through the fields used by social_meta() and write_manifest() at the console and writes the answers to a YAML file. Meant as a quick on-ramp so new users can get a working meta.yml without first reading the field reference.

Usage

init_meta(path = "meta.yml")

Arguments

Value

The path to the written file, invisibly.

Build a generator that calls OpenAI's image API

Description

Returns a function suitable for the generator argument of generate_assets(). The returned function calls OpenAI's image generation endpoint and hands back the raw image bytes, so generate_assets() can write them straight to disk.

Usage

openai_image_generator(
  api_key = Sys.getenv("OPENAI_API_KEY"),
  model = "gpt-image-1"
)

Arguments

Details

This is the only built-in generator shinyseo ships. It exists because OpenAI's image API is a straightforward fit for the job – one endpoint, one request shape, raster images back. Other providers are welcome as community contributions (see LLM.md); shinyseo does not bundle a generator for every LLM vendor, only ones that can actually generate images and pull their weight as a built-in.

Calling this function does not make any network request – it only builds and returns the generator. The 'httr' package is required, but only loaded (via requireNamespace()) when you call this constructor, so it costs nothing if you never use OpenAI generation.

Value

A function function(prompt, kind) that POSTs to https://api.openai.com/v1/images/generations and returns the generated image as a raw vector of bytes.

Inject social metadata into Shiny UI

Description

Inject social metadata into Shiny UI

Usage

social_meta(meta)

Arguments

Details

If meta is a character string, it is treated as a YAML file path and decoded as UTF-8 regardless of the active locale. Set the schema field in meta to FALSE to suppress JSON-LD output. bing_site_verification falls back to SHINYSEO_BING_SITE_VERIFICATION when that environment variable is set. twitter_site and twitter_creator fall back to SHINYSEO_TWITTER_SITE and SHINYSEO_TWITTER_CREATOR when those environment variables are set. The helper does not emit a <title> tag; set the document title in the app UI so it does not clash with an existing Shiny title. If favicon points to an SVG, also set favicon_png to a PNG fallback (e.g. 32x32) – Chromium-based browsers' address bar does not render SVG favicons and shows a generic globe icon without one. favicon_png_sizes overrides the sizes attribute (defaults to "32x32"). Set apple_mobile_web_app_capable = TRUE to let the app run in standalone mode when added to a phone's home screen (emits apple-mobile-web-app-capable and mobile-web-app-capable). apple_mobile_web_app_title sets the name shown under the home screen icon, and apple_mobile_web_app_status_bar_style controls the iOS status bar appearance. Optional verification fields include bing_site_verification, google_site_verification, yandex_site_verification, baidu_site_verification, naver_site_verification, facebook_domain_verification, and pinterest_domain_verification.

Value

A shiny::tags$head() fragment containing canonical, Open Graph, Twitter Card, and optional schema.org metadata.

Reactively update social metadata from the server

Description

Call this inside a Shiny server function to update one or more metadata fields after the page has loaded — for example when the user navigates between tabs or routes. Only the fields you supply are changed; all others stay at whatever value social_meta() set at startup.

Usage

update_meta(
  session,
  title = NULL,
  description = NULL,
  url = NULL,
  image = NULL
)

Arguments

Value

Called for its side-effect; returns invisible(NULL).

Write a web app manifest to the Shiny www directory

Description

Generates a Web App Manifest (manifest.json) and writes it to www/ so Shiny can serve it at /manifest.json. Call this once in global.R before the app starts.

Usage

write_manifest(
  meta,
  path = "www",
  display = "standalone",
  start_url = "/",
  background_color = NULL
)

Arguments

Details

Reference manifest.json from the UI by passing manifest = "/manifest.json" to social_meta().

Value

The path to the written file, invisibly.