@pittankopta/vibranium
CLI for managing custom emulated devices on Chromium-based browsers.
Last updated 2 months ago by pittan .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @pittankopta/vibranium 
SYNC missed versions from official npm registry.

vibranium

CLI for managing custom emulated devices on Chromium-based browsers.

oclif Version Downloads/week License

???? What's this?

Vibranium is a CLI that allows you to import/export custom device emulator settings in Chrome DevTools. If you use custom device emulator feature in Chrome DevTools, you might feel this is pretty handy. Especially if you are a frontend-developer and dealing with WebView using custom user agent , you're gonna love it!

When you are migrating to a new computer, vibranium can help you!
And when you want to share your custom device emulator settings with your colleagues, vibranium can help with that situation, too!

???? Getting started

You can simply use this with typing:

$ npx @pittankopta/vibranium

...or you can install globally/locally

## Install globally
$ npm install -g @pittankopta/vibranium
$ vibranium --version

## Install locally
$ npm install @pittankopta/vibranium --dev
## ...or
$ yarn add @pittankopta/vibranium --dev

✨Features

Export

You can export your custom device emulator settings.
It will output as a JSON file, so you can put it under your version control.
Profile feature is supported, so you can choose a profile to export.

$ npx @pittankopta/vibranium@beta export
$ npx @pittankopta/vibranium@beta export ./path/to/file.json
$ npx @pittankopta/vibranium@beta export --browser chrome-canary

Add

Add a custom device settings from JSON file.
Profile feature is supported, so you can choose a profile to add custom device settings.

$ npx @pittankopta/vibranium@beta add vibranium.json
$ npx @pittankopta/vibranium@beta add vibranium.json  --browser chrome-canary

✅ OS / Browser support

You can select target browser using --browser command.
Available option is chrome chrome-canary chromium. (default is chrome.) If your favorite browser is not listed below, feel free to contribute!

macOS Linux Windows
Chrome ????
Chrome Canary ????
Chromium ????
Edge(Chromium based) - - -
  • ✅: Supported / Tested
  • ????: Just implemented (Not tested)
  • - : Not supported

????️ Roadmap

  • [ ] ???? Add test code
  • [ ] ???? Add integration with CircleCI
  • [ ] ???? Test with Linux
  • [ ] ✨ Add nice documentation site
  • [ ] ???? Add support for other Chromium-based browsers (e.g. Edge)

???? Commands

vibranium add FILE

Add custom emulated devices from a JSON config file.

USAGE
  $ vibranium add FILE

OPTIONS
  -b, --browser=browser  [default: chrome] Specify a browser (e.g. chrome-canary, chromium)
  -f, --force            Skip confirm when overwriting
  -h, --help             show CLI help
  -r, --replace          Replace all your existing emulated devices inside Chrome.

EXAMPLES
  - To add a custom device to your browser, simply type:
       $ vibranium add vibranium.json
       $ vibranium add path/to/the/config.json
  - If you want to swap all the devices with your config, type:
       $ vibranium add vibranium.json --replace
  - If you want to add settings to Chrome Canary, type:
       $ vibranium add --browser chrome-canary

See code: src/commands/add.ts

vibranium export [FILE]

Export custom virtual device list from your Chrome browser.

USAGE
  $ vibranium export [FILE]

OPTIONS
  -b, --browser=browser  [default: chrome] Specify a browser (e.g. chrome-canary, chromium)
  -f, --force            Skip confirm when overwriting
  -h, --help             show CLI help

EXAMPLES
  - To export your custom emulated device settings, simply type:
       $ vibranium export
  - You can specify a directory/name for the output file with:
       $ vibranium export ./path/to/the/config.json
  - If you want to export settings from Chrome Canary, type:
       $ vibranium export --browser chrome-canary

See code: src/commands/export.ts

vibranium help [COMMAND]

display help for vibranium

USAGE
  $ vibranium help [COMMAND]

ARGUMENTS
  COMMAND  command to show help for

OPTIONS
  --all  see all commands in CLI

See code: @oclif/plugin-help

???? Feedback

If you have any issue, suggestion, or question, feel free to make an issue.
Also, contribution is welcome!

Current Tags

  • 1.0.0-alpha.4                                ...           beta (2 months ago)
  • 1.0.0                                ...           latest (2 months ago)

13 Versions

  • 1.0.0                                ...           2 months ago
  • 1.0.0-alpha.4                                ...           2 months ago
  • 1.0.0-alpha.3                                ...           2 months ago
  • 1.0.0-alpha.2                                ...           2 months ago
  • 0.0.11                                ...           a year ago
  • 0.0.10                                ...           a year ago
  • 0.0.7                                ...           2 years ago
  • 0.0.6                                ...           2 years ago
  • 0.0.5                                ...           2 years ago
  • 0.0.4                                ...           2 years ago
  • 0.0.3                                ...           2 years ago
  • 0.0.2                                ...           2 years ago
  • 0.0.1                                ...           2 years ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 1
Dependents (0)
None

Copyright 2014 - 2017 © taobao.org |