help vcontrolvcontrol v1.0 (GitHub)

vcontrol

: Version control command for Stata packages (beta)

Description

vcontrol compares version dates of a Stata package available on SSC and GitHub (or a custom URL).
It displays the distribution dates for both sources and identifies which version is newer.

If the update option is specified, the latest version is automatically installed
from the source with the more recent distribution date.

Syntax

vcontrol package [, url(string) update replace]

Main
package Name of the package to check (required).

Options
url(string) Custom GitHub installation URL used to check and install the package. Default: https://raw.githubusercontent.com/asjadnaqvi/stata-<package>/refs/heads/main/installation.

update Install the latest version after checking dates.

replace Pass replace to ssc install or net install during update.

* package is required.

Examples

Check version of tidytuesday package:

vcontrol tidytuesday

Check and update if a newer version is available:

vcontrol tidytuesday, update

Update and force reinstallation when needed:

vcontrol tidytuesday, update replace

Check with custom GitHub installation URL:

Feedback

Please submit bugs, errors, and feature requests on GitHub by opening a new issue.

Citation guidelines

Please cite the version you use (SSC or GitHub). The GitHub version may have updates not yet released on SSC.
Visit the GitHub repository for the most up-to-date version.

Package details

Version : vcontrol v1.0
This release : 01 Apr 2026
First release: 16 Feb 2026
Repository : GitHub
Keywords : Stata, version control, package management
License : MIT

Author : Asjad Naqvi
E-mail : asjadnaqvi@gmail.com
Twitter/X : @AsjadNaqvi
BlueSky : @asjadnaqvi.bsky.social

Other visualization packages

arcplot, alluvial, bimap, bumparea, bumpline, circlebar, circlepack, clipgeo, delaunay, graphfunctions, geoboundary, geoflow, joyplot,
marimekko, polarspike, sankey, schemepack, spider, splinefit, streamplot, sunburst, ternary, treecluster, treemap,
trimap, vcontrol, waffle

Visit GitHub for further information.