{ "_id": "6abcb44699f7aa8c6aa4aaee", "Package": "shinyelectron", "Title": "Export 'Shiny' Applications as Desktop Apps using 'Electron'", "Version": "0.2.1", "Authors@R": "c(\nperson(\"James Joseph\", \"Balamuta\",\nemail = \"james.balamuta@gmail.com\",\nrole = c(\"aut\", \"cre\", \"cph\"),\ncomment = c(ORCID = \"0000-0003-2826-8458\")\n)\n)", "Description": "Provides tools to export 'Shiny' applications written in\n'R' or 'Python' as standalone desktop applications using\n'Electron'. The applications run as native, cross-platform\nprograms. Depending on the runtime strategy chosen, end users\ndo not need 'R' or 'Python' installed on their machine.", "License": "AGPL (>= 3)", "URL": "https://r-pkg.thecoatlessprofessor.com/shinyelectron/,\nhttps://github.com/coatless-rpkg/shinyelectron", "BugReports": "https://github.com/coatless-rpkg/shinyelectron/issues", "VignetteBuilder": "quarto", "SystemRequirements": "Node.js (>= 22.0.0), npm (>= 11.5.0)", "Encoding": "UTF-8", "Roxygen": "list(markdown = TRUE)", "Config/testthat/edition": "3", "Config/roxygen2/version": "8.0.0", "Config/pak/sysreqs": "cmake make libuv1-dev", "Repository": "https://coatless-rpkg.r-universe.dev", "Date/Publication": "2026-09-30 05:17:58 UTC", "RemoteUrl": "https://github.com/coatless-rpkg/shinyelectron", "RemoteRef": "HEAD", "RemoteSha": "b334020d9e84b5f9b9eb6d804b846753880cdbc8", "NeedsCompilation": "no", "Packaged": { "Date": "2026-09-30 06:58:51 UTC", "User": "root" }, "Author": "James Joseph Balamuta [aut, cre, cph] (ORCID:\n)", "Maintainer": "James Joseph Balamuta ", "_user": "coatless-rpkg", "_type": "src", "_file": "shinyelectron_0.2.1.tar.gz", "_fileid": "https://r2.ropensci.org/8238626672a44cf9205199487abc9f91efa794280b4d02cf6e387937cf6540de", "_filesize": 859020, "_sha256": "8238626672a44cf9205199487abc9f91efa794280b4d02cf6e387937cf6540de", "_expires": "2027-01-08T07:03:32.000Z", "_created": "2026-09-30T06:58:51.000Z", "_published": "2026-09-30T07:03:34.273Z", "_jobs": [ { "job": 109776694641, "time": 206, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "ERROR", "artifact": "11081553249" }, { "job": 109776694610, "time": 200, "config": "linux-release-x86_64", "r": "4.6.1", "check": "ERROR", "artifact": "11082037523" }, { "job": 109776694629, "time": 197, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "ERROR", "artifact": "11081847612" }, { "job": 109776694731, "time": 175, "config": "macos-release-arm64", "r": "4.6.1", "check": "ERROR", "artifact": "11082290698" }, { "job": 109775487427, "time": 259, "config": "source", "r": "4.6.1", "check": "OK", "artifact": "11081308008" }, { "job": 109776695939, "time": 137, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "11081434764" }, { "job": 109776694729, "time": 212, "config": "windows-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "11082131204" }, { "job": 109776694670, "time": 225, "config": "windows-oldrel-x86_64", "r": "4.5.3", "check": "OK", "artifact": "11081747973" }, { "job": 109776694761, "time": 231, "config": "windows-release-x86_64", "r": "4.6.1", "check": "OK", "artifact": "11082370397" } ], "_host": "GitHub-Actions", "_buildurl": "https://github.com/r-universe/coatless-rpkg/actions/runs/36680731049", "_status": "success", "_upstream": "https://github.com/coatless-rpkg/shinyelectron", "_commit": { "id": "b334020d9e84b5f9b9eb6d804b846753880cdbc8", "author": "James J Balamuta ", "committer": "GitHub ", "message": "Point every platform's icon at the file the build copies (#47)\n\nThe generated `package.json` names the icon file the build actually copies for every platform that can use it, instead of fixed `icon.ico`, `icon.icns` and `icon.png` names that mostly did not exist. A platform the icon cannot serve, by format or by electron-builder's minimum size, keeps the default icon with a warning from `export()` and `app_check()`. A `tray.icon` named like the icon copy no longer overwrites it, and unused `icons` entries draw a warning.", "time": 1790745478 }, "_maintainer": { "name": "James Joseph Balamuta", "email": "james.balamuta@gmail.com", "login": "coatless", "mastodon": "@coatless@mastodon.social", "linkedin": "in/jamesbalamuta", "twitter": "@axiomsofxyz", "description": "omnipresent explorer of the unknown, fashionably caffeinated informatics phd, amorous cavalier. design, build, analyze. #rstats #python @tmsalab", "uuid": 833642, "orcid": "0000-0003-2826-8458" }, "_distro": "resolute", "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 4.5.0", "role": "Depends" }, { "package": "cli", "version": ">= 3.6.6", "role": "Imports" }, { "package": "fs", "version": ">= 2.1.0", "role": "Imports" }, { "package": "jsonlite", "version": ">= 2.0.0", "role": "Imports" }, { "package": "rappdirs", "version": ">= 0.3.4", "role": "Imports" }, { "package": "rlang", "version": ">= 1.1.0", "role": "Imports" }, { "package": "whisker", "version": ">= 0.4.1", "role": "Imports" }, { "package": "processx", "version": ">= 3.9.0", "role": "Imports" }, { "package": "stats", "role": "Imports" }, { "package": "tools", "role": "Imports" }, { "package": "utils", "role": "Imports" }, { "package": "yaml", "version": ">= 2.3.12", "role": "Imports" }, { "package": "testthat", "version": ">= 3.3.2", "role": "Suggests" }, { "package": "mockery", "version": ">= 0.4.5", "role": "Suggests" }, { "package": "quarto", "version": ">= 1.5.1", "role": "Suggests" }, { "package": "renv", "version": ">= 1.2.3", "role": "Suggests" }, { "package": "shinylive", "version": ">= 0.5.0", "role": "Suggests" }, { "package": "withr", "version": ">= 3.0.3", "role": "Suggests" } ], "_owner": "coatless-rpkg", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2026-17", "n": 2 }, { "week": "2026-18", "n": 2 }, { "week": "2026-26", "n": 4 }, { "week": "2026-27", "n": 31 }, { "week": "2026-29", "n": 11 }, { "week": "2026-31", "n": 8 }, { "week": "2026-38", "n": 1 }, { "week": "2026-40", "n": 22 } ], "_tags": [ { "name": "v0.2.0", "date": "2026-07-02" }, { "name": "v0.2.1", "date": "2026-07-29" } ], "_topics": [ "electron-app", "r-shiny", "r-shinylive", "shiny", "shiny-app", "standalone-app", "quarto" ], "_stars": 117, "_contributors": [ { "user": "coatless", "count": 102, "uuid": 833642 }, { "user": "fentouxungui", "count": 1, "uuid": 43262531 } ], "_userbio": { "uuid": 97069866, "type": "organization", "name": "Various R Packages", "followers": 27, "description": "R packages created by @coatless and contributors" }, "_downloads": { "count": 428, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/shinyelectron" }, "_devurl": "https://github.com/coatless-rpkg/shinyelectron", "_pkgdown": "https://r-pkg.thecoatlessprofessor.com/shinyelectron/", "_searchresults": 22, "_quarto": true, "_rbuild": "4.6.1", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/manual.pdf", "extra/NEWS.html", "extra/NEWS.txt", "extra/readme.html", "extra/readme.md", "extra/shinyelectron.html" ], "_homeurl": "https://github.com/coatless-rpkg/shinyelectron", "_realowner": "coatless-rpkg", "_cranurl": true, "_releases": [ { "version": "0.2.1", "date": "2026-08-07" } ], "_exports": [ "app_check", "app_dependencies", "available_examples", "build_electron_app", "cache_clear", "cache_dir", "cache_info", "cache_remove", "check_auto_update_status", "convert_py_to_shinylive", "convert_shiny_to_shinylive", "disable_auto_updates", "enable_auto_updates", "example_app", "export", "init_config", "install_nodejs", "install_python_standalone", "install_r_portable", "run_electron_app", "show_config", "sitrep_electron_build_tools", "sitrep_electron_dependencies", "sitrep_electron_project", "sitrep_electron_system", "sitrep_shinyelectron", "wizard" ], "_help": [ { "page": "app_check", "title": "Check Shiny Application Readiness for Export", "topics": [ "app_check" ] }, { "page": "app_dependencies", "title": "Detect an app's package dependencies", "topics": [ "app_dependencies" ] }, { "page": "available_examples", "title": "List Available Examples", "topics": [ "available_examples" ] }, { "page": "build_electron_app", "title": "Build Electron Application", "topics": [ "build_electron_app" ] }, { "page": "cache_clear", "title": "Clear the asset cache", "topics": [ "cache_clear" ] }, { "page": "cache_dir", "title": "Get or create the cache directory path", "topics": [ "cache_dir" ] }, { "page": "cache_info", "title": "Show cached runtime information", "topics": [ "cache_info" ] }, { "page": "cache_remove", "title": "Remove a specific cached runtime version", "topics": [ "cache_remove" ] }, { "page": "check_auto_update_status", "title": "Check Auto-Update Status", "topics": [ "check_auto_update_status" ] }, { "page": "convert_py_to_shinylive", "title": "Convert Python Shiny Application to Shinylive", "topics": [ "convert_py_to_shinylive" ] }, { "page": "convert_shiny_to_shinylive", "title": "Convert Shiny Application to Shinylive", "topics": [ "convert_shiny_to_shinylive" ] }, { "page": "disable_auto_updates", "title": "Disable Auto-Updates", "topics": [ "disable_auto_updates" ] }, { "page": "enable_auto_updates", "title": "Enable Auto-Updates", "topics": [ "enable_auto_updates" ] }, { "page": "example_app", "title": "Get Path to an Example Application", "topics": [ "example_app" ] }, { "page": "export", "title": "Export Shiny Application as Electron Desktop Application", "topics": [ "export" ] }, { "page": "init_config", "title": "Initialize configuration file", "topics": [ "init_config" ] }, { "page": "install_nodejs", "title": "Install Node.js locally", "topics": [ "install_nodejs" ] }, { "page": "install_python_standalone", "title": "Install a portable Python distribution", "topics": [ "install_python_standalone" ] }, { "page": "install_r_portable", "title": "Install a portable R distribution", "topics": [ "install_r_portable" ] }, { "page": "run_electron_app", "title": "Run Electron Application for Testing", "topics": [ "run_electron_app" ] }, { "page": "show_config", "title": "Show Effective Configuration", "topics": [ "show_config" ] }, { "page": "sitrep_electron_build_tools", "title": "Build Tools Situation Report", "topics": [ "sitrep_electron_build_tools" ] }, { "page": "sitrep_electron_dependencies", "title": "Dependencies Situation Report", "topics": [ "sitrep_electron_dependencies" ] }, { "page": "sitrep_electron_project", "title": "Project Situation Report", "topics": [ "sitrep_electron_project" ] }, { "page": "sitrep_electron_system", "title": "System Requirements Situation Report", "topics": [ "sitrep_electron_system" ] }, { "page": "sitrep_shinyelectron", "title": "Complete Situation Report", "topics": [ "sitrep_shinyelectron" ] }, { "page": "wizard", "title": "Interactive Configuration Wizard", "topics": [ "wizard" ] } ], "_readme": "https://github.com/coatless-rpkg/shinyelectron/raw/HEAD/README.md", "_rundeps": [ "cli", "fs", "jsonlite", "processx", "ps", "R6", "rappdirs", "rlang", "whisker", "yaml" ], "_vignettes": [ { "source": "auto-updates.qmd", "filename": "auto-updates.html", "title": "Automatic Updates", "engine": "quarto::html", "headings": [ "Pick a publish host", "Quick start", "GitHub Releases", "Configure the app", "Build the app", "Publish a release", "What the user sees", "Configuration", "Three knobs, one pipeline", "Private repositories", "S3", "Generic HTTP", "Code signing", "macOS", "Windows", "Turning updates off", "Troubleshooting", "The check fails", "Downloads, never installs", "Always \"No updates available\"", "Debug logging", "Publishing from CI", "Next steps" ], "created": "2026-04-22 00:58:16", "modified": "2026-09-29 21:04:11", "commits": 8 }, { "source": "github-actions.qmd", "filename": "github-actions.html", "title": "Building with GitHub Actions", "engine": "quarto::html", "headings": [ "Why automate", "Before you start", "Use the bundled workflow", "Configure it", "What the matrix builds", "Push and tag", "Status badge", "Customising", "App in a different folder", "Narrower platform list", "Runtime strategy", "Icons and other options", "Config file wins, action inputs override", "Signing in CI", "Roll your own", "CI-specific troubleshooting", "appdir points at the wrong directory", "Linux build fails on missing libraries", "shinylive build stops with \"there is no package called ...\"", "Pin the shinyelectron version", "Job hits the six-hour limit", "Next steps" ], "created": "2026-04-22 00:58:16", "modified": "2026-09-29 21:04:11", "commits": 7 }, { "source": "code-signing.qmd", "filename": "code-signing.html", "title": "Code Signing and Distribution", "engine": "quarto::html", "headings": [ "When signing matters", "Turning signing on", "macOS: sign and notarize", "Windows: sign with a code signing certificate", "Linux: optional GPG signing", "Signing in CI", "Development versus production", "Environment variables reference", "Next steps" ], "created": "2026-04-22 00:58:16", "modified": "2026-09-30 01:51:02", "commits": 8 }, { "source": "configuration.qmd", "filename": "configuration.html", "title": "Configuration Guide", "engine": "quarto::html", "headings": [ "Why use one", "Getting a config file in place", "Complete reference", "How values get resolved", "File paths", "Section reference", "app", "Settle the slug before you ship", "build", "Cross-platform caveats", "icon and icons", "Creating icons", "window", "server", "nodejs", "auto_install is planned, not yet active", "dependencies", "Version keys", "Detection and extra packages", "R-specific dependency options", "Pruning the bundled R runtime", "Local R packages", "Python-specific dependency options", "system_packages", "container", "apps", "logging", "lifecycle", "signing", "installer", "Decide on per_machine before the first release", "Build Windows installers on Windows", "Common recipes", "Development setup", "Production multi-platform build", "Native R app with bundled runtime", "Multi-app suite", "What happens when a value is invalid", "Next steps" ], "created": "2026-04-22 00:58:16", "modified": "2026-09-30 05:17:58", "commits": 19 }, { "source": "container-strategy.qmd", "filename": "container-strategy.html", "title": "Container Strategy", "engine": "quarto::html", "headings": [ "When to reach for a container", "Prerequisites", "The launch flow", "Configuration", "Where the image comes from", "Built-in R image", "Built-in Python image", "System dependency baking", "Registry image", "Passing volumes and env vars", "Verifying the engine", "Limitations", "Platform notes" ], "created": "2026-04-22 00:58:16", "modified": "2026-09-29 21:04:11", "commits": 8 }, { "source": "customizations.qmd", "filename": "customizations.html", "title": "Customizations", "engine": "quarto::html", "headings": [ "Lifecycle window", "Splash", "Preloader", "Advanced lifecycle options", "System tray", "What the buttons do", "Tray menu", "Tray icon, per platform", "Application menu", "What each template ships", "Platform conventions", "About dialog", "DevTools", "Wiring it all together", "Editing config from R", "Next steps" ], "created": "2026-04-25 14:57:49", "modified": "2026-09-30 01:50:36", "commits": 8 }, { "source": "getting-started.qmd", "filename": "getting-started.html", "title": "Getting Started with shinyelectron", "engine": "quarto::html", "headings": [ "Install the package", "Run a pre-flight check", "Build a demo end to end", "Try a prebuilt demo", "Export your Shiny app", "Shinylive: runs in the browser", "Native: runs a real R or Python process", "Choose an app type and runtime strategy", "What export produces", "Build for several platforms in one call", "Give the app a custom icon", "Capture build settings in a config file", "Where to go next", "Function cheat sheet" ], "created": "2026-04-22 00:58:16", "modified": "2026-09-30 05:17:58", "commits": 10 }, { "source": "multi-app-suites.qmd", "filename": "multi-app-suites.html", "title": "Multi-App Suites", "engine": "quarto::html", "headings": [ "Layout", "R suite", "Python suite", "Configuration", "R suite config", "Python suite config", "Fields in an apps entry", "Mixed-strategy suites", "How dependencies are handled", "R apps", "Python apps", "Exporting a suite", "Launcher and app switching", "One runtime, one active app", "Building your own suite" ], "created": "2026-04-22 00:58:16", "modified": "2026-09-30 01:50:22", "commits": 7 }, { "source": "nodejs-management.qmd", "filename": "nodejs-management.html", "title": "Node.js Management", "engine": "quarto::html", "headings": [ "Why a local install", "Installing", "Which Node.js shinyelectron uses", "Auto-install from _shinyelectron.yml (planned)", "Not yet implemented", "Cache layout", "Download integrity", "Clearing the cache", "Local versus system", "Troubleshooting", "Network error during download", "Checksum mismatch", "Wrong architecture", "Local install skipped", "Next steps" ], "created": "2026-04-22 00:58:16", "modified": "2026-09-29 18:10:06", "commits": 6 }, { "source": "runtime-strategies.qmd", "filename": "runtime-strategies.html", "title": "Runtime Strategies", "engine": "quarto::html", "headings": [ "Picking a strategy", "Shinylive strategy", "The export flow", "Tradeoffs", "System strategy", "The launch flow", "Bundled strategy", "The build flow", "Local R packages", "Auto-download strategy", "Container strategy", "Platform considerations", "Portable runtime coverage", "Cross-platform builds", "macOS code signing", "Next steps" ], "created": "2026-04-22 00:58:16", "modified": "2026-09-30 02:00:59", "commits": 10 }, { "source": "security.qmd", "filename": "security.html", "title": "Security Considerations", "engine": "quarto::html", "headings": [ "Two processes, one trust boundary", "What shinyelectron locks down", "Content-Security-Policy scope", "Cross-origin headers (Shinylive only)", "Runtime download integrity", "Where your app still has to think", "Inputs are user-controlled", "File access is user-wide", "Secrets and per-user credentials", "Giving each user their own token", "Never bundle credentials", "Strategy-specific notes", "Shinylive", "System, bundled, auto-download", "Container", "Distribution", "What not to do", "Do not modify these settings in the generated Electron code", "Summary" ], "created": "2026-04-22 00:58:16", "modified": "2026-09-29 18:03:56", "commits": 5 }, { "source": "troubleshooting.qmd", "filename": "troubleshooting.html", "title": "Troubleshooting Guide", "engine": "quarto::html", "headings": [ "Start with a full report", "Targeted diagnostics", "Local versus system Node.js", "Reading sitrep results in code", "Install-time problems", "Node.js not found", "Node.js version too old", "npm not found", "Missing R packages", "Xcode Command Line Tools missing (macOS)", "Visual Studio Build Tools missing (Windows)", "Build tools missing (Linux)", "Python not found", "Python shinylive CLI not working", "Python shiny package not installed", "Docker or Podman not found", "Docker on Parallels and other nested virtualization", "Build-time problems", "package.json not found", "node_modules not found", "Container image pull failure", "Container port conflict", "GNU tar versus bsdtar on Windows", "EBUSY file locks when rebuilding (Windows)", "Slow builds (Windows)", "Runtime problems", "R not on PATH (Windows)", "Gatekeeper blocks the app (macOS)", "SmartScreen blocks the installer (Windows)", "Clear the cache", "Debugging a packaged app", "Deprecation warnings: shinylive as an app type", "Getting help", "Next steps" ], "created": "2026-04-22 00:58:16", "modified": "2026-09-30 01:51:02", "commits": 7 } ], "_score": 8.091849779943955, "_indexed": true, "_nocasepkg": "shinyelectron", "_universes": [ "coatless-rpkg", "coatless" ], "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "0.2.1", "date": "2026-09-30T07:01:27.000Z", "distro": "resolute", "commit": "b334020d9e84b5f9b9eb6d804b846753880cdbc8", "fileid": "https://r2.ropensci.org/416623856abdf9ff45e7ce216a85dcaddc8800309d8ece7e4c13dbf8fbc3b1f9", "status": "failure", "check": "ERROR", "buildurl": "https://github.com/r-universe/coatless-rpkg/actions/runs/36680731049" }, { "r": "4.6.1", "os": "linux", "version": "0.2.1", "date": "2026-09-30T07:01:25.000Z", "distro": "resolute", "commit": "b334020d9e84b5f9b9eb6d804b846753880cdbc8", "fileid": "https://r2.ropensci.org/31a91234b37f0d34083abb7e0bf3939556ea004f7aad7c98e28ef3c69f754363", "status": "failure", "check": "ERROR", "buildurl": "https://github.com/r-universe/coatless-rpkg/actions/runs/36680731049" }, { "r": "4.5.3", "os": "mac", "version": "0.2.1", "date": "2026-09-30T07:01:48.000Z", "commit": "b334020d9e84b5f9b9eb6d804b846753880cdbc8", "fileid": "https://r2.ropensci.org/3dc2b7652b5de6377ca9a82f16282d413d181f57a3161fb2d2d5e6a6ae0d7fab", "status": "failure", "check": "ERROR", "buildurl": "https://github.com/r-universe/coatless-rpkg/actions/runs/36680731049" }, { "r": "4.6.1", "os": "mac", "version": "0.2.1", "date": "2026-09-30T07:01:45.000Z", "commit": "b334020d9e84b5f9b9eb6d804b846753880cdbc8", "fileid": "https://r2.ropensci.org/e9c82edd9d76b2d02a41bbb8418592cb62d30bcecb68cab2a580e09797f99633", "status": "failure", "check": "ERROR", "buildurl": "https://github.com/r-universe/coatless-rpkg/actions/runs/36680731049" }, { "r": "4.6.0", "os": "wasm", "version": "0.2.1", "date": "2026-09-30T07:01:33.000Z", "commit": "b334020d9e84b5f9b9eb6d804b846753880cdbc8", "fileid": "https://r2.ropensci.org/bb36f85546e73b50bac4a75c89892e0f4b5d8702f7a869189a865738725a1acf", "status": "success", "buildurl": "https://github.com/r-universe/coatless-rpkg/actions/runs/36680731049" }, { "r": "4.7.0", "os": "win", "version": "0.2.1", "date": "2026-09-30T07:00:37.000Z", "commit": "b334020d9e84b5f9b9eb6d804b846753880cdbc8", "fileid": "https://r2.ropensci.org/bb626405e5b2595c81495bc5d1f0b3db5265456b45f5afae6df8ffa3306fb7a1", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/coatless-rpkg/actions/runs/36680731049" }, { "r": "4.5.3", "os": "win", "version": "0.2.1", "date": "2026-09-30T07:00:57.000Z", "commit": "b334020d9e84b5f9b9eb6d804b846753880cdbc8", "fileid": "https://r2.ropensci.org/031ab8ff62e256444e3790d54c66a26fb76744c01c6719e258d07876442647dc", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/coatless-rpkg/actions/runs/36680731049" }, { "r": "4.6.1", "os": "win", "version": "0.2.1", "date": "2026-09-30T07:01:01.000Z", "commit": "b334020d9e84b5f9b9eb6d804b846753880cdbc8", "fileid": "https://r2.ropensci.org/2437c91bc1b623a12160122683d82a2818a1c16fdb7722cc4be8ade73dc1b574", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/coatless-rpkg/actions/runs/36680731049" } ] }