Motivation

You’ll know from Every Google Apps Script project on Github visualized that you can get a very large diagram of all known public Apps Script projects and from Find and clone Apps Script projects from github directly into the IDE with scrviz that you can clone a project from Github directly to a new Apps Script project. This extends that idea so that you can send a personalized link to someone that finds and focuses on a given owner, repo or project – if you send a project link it makes it easy for you to distribute your code and for the recipient to make his own project directly from github. You can also distribute a link directly to your personal scrviz card to help  Showcase your Apps Script work and get hired via vizzy

Getting a link

The easiest way to get a direct link is to find the card you want to distribute on scrviz and copy the link on the card. For example, here’s my own card.

You’ll see that you can copy the direct link – which will look like this

https://scrviz.web.app/?owner=brucemcpherson

If you share this link it will kick off scrviz positioned in the visualization at my card, and with it pinned.

Sharing repos

Sharing a repo is exactly the same procedure

Here’s the link to my gasGit repo

https://scrviz.web.app?repo=brucemcpherson%2FgasGit

Sharing a project

This is the most interesting option. You can share a manifest (the appsscript.json) to allow the immediate cloning of that project.

Here’s the link to my cGoa library project

https://scrviz.web.app?manifest=brucemcpherson%2FcGoa%2Fappsscript.json

So now whoever has this link configure and clone into the IDE

 

Summary

You can of course create your own links manually or programatically rather than picking them up from scrviz. The supported parameters for https://scrviz.web.app are

  • ?owner=github-login – eg. ?owner=brucemcpherson
  • ?repo=github-repo – eg. ?repo=brucemcpherson/cGoa
  • ?manifest=github-path-toappsscriptjson  -eg. ?manifest=brucemcpherson/cGoa/appsscript.json

and you may want to uri encode them just in case.

Technical note

I had some fun figuring out how to position at the initial card in the D3 visualization, but it’s all good now. I’ll do a separate article on that for those that interested in D3.

 

Links

App https://scrviz.web.app

Github https://github.com/brucemcpherson/gitvizzy

 

All about scrviz