{"id":46868169,"url":"https://github.com/cynkra/dockViewR","last_synced_at":"2026-03-24T21:01:31.999Z","repository":{"id":281650407,"uuid":"945952202","full_name":"cynkra/dockViewR","owner":"cynkra","description":"Layout Manager Widget for R and Shiny","archived":false,"fork":false,"pushed_at":"2026-03-19T07:40:24.000Z","size":16204,"stargazers_count":31,"open_issues_count":14,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-03-20T00:42:01.538Z","etag":null,"topics":["layout","panels","shiny"],"latest_commit_sha":null,"homepage":"https://cynkra.github.io/dockViewR/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cynkra.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-10T11:38:07.000Z","updated_at":"2026-03-19T07:25:33.000Z","dependencies_parsed_at":"2025-04-01T10:26:06.578Z","dependency_job_id":"daf91bd9-b30e-48f6-a2ba-b8492e944b96","html_url":"https://github.com/cynkra/dockViewR","commit_stats":null,"previous_names":["cynkra/dockviewr"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/cynkra/dockViewR","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cynkra%2FdockViewR","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cynkra%2FdockViewR/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cynkra%2FdockViewR/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cynkra%2FdockViewR/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cynkra","download_url":"https://codeload.github.com/cynkra/dockViewR/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cynkra%2FdockViewR/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30905707,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-24T08:58:18.477Z","status":"ssl_error","status_checked_at":"2026-03-24T08:57:59.595Z","response_time":106,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["layout","panels","shiny"],"created_at":"2026-03-10T19:00:29.877Z","updated_at":"2026-03-24T21:01:31.984Z","avatar_url":"https://github.com/cynkra.png","language":"R","funding_links":[],"categories":["UI Components"],"sub_categories":["Bootstrap"],"readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"man/figures/README-\",\n  out.width = \"100%\"\n)\n```\n\n# dockViewR\n\n\u003c!-- badges: start --\u003e\n[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)\n[![CRAN status](https://www.r-pkg.org/badges/version/dockViewR)](https://CRAN.R-project.org/package=dockViewR)\n[![R-CMD-check](https://github.com/cynkra/dockViewR/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/cynkra/dockViewR/actions/workflows/R-CMD-check.yaml)\n[![Codecov test coverage](https://codecov.io/gh/cynkra/dockViewR/graph/badge.svg)](https://app.codecov.io/gh/cynkra/dockViewR)\n\u003c!-- badges: end --\u003e\n\nThe goal of dockViewR is to provide a layout manager for Shiny apps and interactive R documents. It builds on top of [dockview](https://dockview.dev/).\n\n## Installation\n\nThe latest version of the dockViewR package can be obtained from [CRAN](https://CRAN.R-project.org/package=dockViewR):\n\n```r\n# install.packages(\"pak\")\npak::pak(\"dockViewR\")\n```\n\nOr, you can install the development version of dockViewR like so:\n\n``` r\npak::pak(\"cynkra/dockViewR\")\n```\n\n## Example\n\nThis is a basic example which shows you how spin up a simple dockview app:\n\n```{r, results=\"asis\", echo=FALSE, warning=FALSE, comment = \"\"}\ndockViewR:::print_r_code(\"examples/demo/app.R\")\n```\n\n## Contributing\n\nWe welcome contributions! If you’d like to help improve `{dockViewR}`, feel free to submit issues, feature requests, or pull requests.\n\n### Knowledge pre-requisites\n\n`{dockViewR}` is an __htmlwidget__, an interactive widget for R, powered by a JS library. To get a minimum starting kit:\n\n- JavaScript for R devs: https://book.javascript-for-r.com/.\n- About htmlwidgets: https://www.htmlwidgets.org/develop_intro.html.\n\n### Software pre-requisite\n\nTo contribute to this project, you'll need `npm`, `node`, and the R package `{packer}` to compile the JavaScript code. Please follow guide [here](https://packer.john-coene.com/#/guide/installation). When you are in the project, do the following:\n\n```r\npak::pak(\"packer\")\n# Restore JavaScript dependencies in package-lock.json (a bit like the renv.lock)\npacker::npm_install()\n```\n\nThe JS code uses [ES6 modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules), meaning that you can define a module in a `srcjs/component.js` script as follows:\n\n```js\nexport const blabla = () =\u003e {\n  console.log(\"Blabla\");\n}\n```\n\nand use it in another script, let's say `./otherscript.js` like so:\n\n```js\n// ./otherscript.js\nimport { blabla } from './components.js'\n```\n\nWhenever you are done with changing the JS script, you have to rebuild it:\n\n```r\n# Change the code and then rebundle\npacker::bundle(\"development\") # For developement mode\npacker::bundle() # For production. Defaut!\n```\n\nYou may as well bundle for `dev` using `packer::bundle_dev()` when in developer mode and when ready for production use `packer::bundle_prod()`. You may also consider `watch()` which watches for changes in the `srcjs` and rebuilds if necessary, equivalent to `⁠npm run watch⁠`.\n\n### Debugging steps\n\n1. Whenever you run an app using `{dockViewR}`, like in `inst/examples/demo`, open the viewer on a\nweb browser window (preferably Chrome as it is used to illustrate the action in this step, as other browser devtools differ in term of layout).\n2. Right-click on the widget and navigate to the `inspect` option on the drop-down menu.\n3. At the top, where the tabs are displayed, navigate to the `Sources` tab. Open from the sidepanel `dockviewer/srcjs/widgets/dockview.js` script\n![Inspector tabs are opened](inst/images/debug.png). Once the `dockview.js` script is opened on the main panel. You can set a breakpoint on any line number of the script and reload the page.\n\n## Acknowledgments\n\nThis package is built on top of the amazing [dockview](https://dockview.dev/) JavaScript library.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcynkra%2FdockViewR","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcynkra%2FdockViewR","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcynkra%2FdockViewR/lists"}