@politico/interactive-bin
v1.2.1
Published
JS Utilities used in the creation and distribution of interactive news at POLITICO.
Downloads
55
Maintainers
Keywords
Readme
@politico/interactive-bin
JS Utilities used in the creation and distribution of interactive news at POLITICO.
Quick Start
Installation:
$ npm install -g @politico/interactive-bin
One-Time Setup (if you work at POLITICO, check out the POLITICO Onboarding Guide):
$ pib setup
Then you can use its commands by running:
$ pib <command> <...arguments>
Starting a New Interactive
To start a new interactive, make an empty directory.
$ mkdir MY_INTERACTIVE_NAME
$ cd MY_INTERACTIVE_NAME
Then run the new project command:
$ pib new project
Using the CLI
Once you have pib
installed you can access the CLI's many commands. Check out those docs for more on what they are and how to use them.
Using PIB In Interactives
For the most part, the PIB CLI should only be used to create new projects. Once inside a PIB-made interactive you should switch to using the yarn
commands that come with those PIB projects. This will ensure that all the files and folder paths are processed correctly.
For example,
✅ yarn api new
✅ yarn new page
✅ yarn pub
❌ pib api new
❌ pib new page
❌ pib publish
PIB has some (many) opinions on how to structure your projects. These are somewhat enforced with your starting template, but you can check out the projects docs for more.