BUBLÉ(1)

πŸ’– BUBLΓ‰(1) β€” the bestie guide πŸ’–

okay so real talk, this is the manual page for BublΓ©, and I'm gonna walk you through it like we're texting at 1am. it's giving "user commands" energy, and honestly? iconic. let's get into it. πŸ¦‹


✨ NAME ✨

BublΓ© β€” a fast ES2015 compiler for Node.js. no cap, it's quick. πŸ’…


🌸 SYNOPSIS 🌸

buble [options] <inputfile>

like, that's the whole vibe. options, then your file. periodt.


πŸŽ€ DESCRIPTION πŸŽ€

so BublΓ© is an ES2015 compiler πŸ’– it takes your ES6 javascript code and turns it into Javascript that can actually run in older ES5 environments. your ancient runtime gets to eat, bestie. πŸ“

but listen β€” not all of ES6 is supported. some stuff gets skipped, either because it gives size or performance issues, or because it literally can't be transpiled to ES5. it's not personal, it's just physics. 😭

πŸ’… OPTIONS πŸ’…

  • -v, --version β€” shows the version number. the "who even am I" check. πŸ‘‘
  • -h, --help β€” shows this help message. it's me, I'm the help message. 🫢
  • -i, --input β€” your Input. this is the alternative to using <entry file>, so pick your fighter. ✨
  • -o, --output <output> β€” your Output. and if you don't give one? it just prints to stdout. no file, just vibes on your terminal. 🌈
  • -m, --sourcemap β€” generates a sourcemap. want it inline? do -m inline and slay. πŸ—ΊοΈ
  • -t, --target β€” selects your compilation targets. tell it who you're performing for. 🎯
  • -y, --yes β€” transforms to always apply. this one overrides --target, so it's got main character energy. πŸ”₯
  • -n, --no β€” transforms to always skip. also overrides --target. the hater of the group, respectfully. πŸ™ˆ
  • --jsx β€” custom JSX pragma. bring your own. 🧚
  • --objectAssign β€” specify Object.assign or an equivalent polyfill. πŸ’œ
  • --no-named-function-expr β€” don't output named function expressions. we're keeping it anonymous, mysterious, unbothered. πŸ’€

⭐ EXAMPLES ⭐

these are copy-paste-able, do not come for me:

# Compile input.js to output.js
buble input.js > output.js
# Compile input.js to output.js, write sourcemap to output.js.map
buble input.js -o output.js -m
# Compile input.js to output.js with inline sourcemap
buble input.js -o output.js -m inline
# Only use transforms necessary for output.js to run in FF43 and Node 5
buble input.js -o output.js -t firefox:43,node:5
# As above, but use arrow function and destructuring transforms
buble input.js -o output.js -t firefox:43,node:5 -y arrow,destructuring
# Compile all the files in src/ to dest/
buble src -o dest

πŸ“ Notes: πŸ“

  • When piping to stdout, only inline sourcemaps are permitted. that's the rule, bestie. no regular maps when you're streaming, sorry. 😀

🌟 SEE ALSO 🌟

want more? go read the guide, it's right here:

http://buble.surge.sh/guide


aaaand that's the whole page, you ate it. πŸ’– this was BublΓ© version 0.15.2, dated September 2017, and it lives in the User Commands corner of your manual. go compile something cute. bye bestie! πŸŽ€βœ¨πŸ¦‹