JS Utilities used in the creation and distribution of interactive news at POLITICO.
$ 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.
yarn api new ✅
yarn new page ✅
pib api new ❌
pib new page ❌
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.