Lebeben-go NPM

Lebeben

lebeben-go

Lebeben is a single CLI to transpile, bundle, watch, and serve your javascript SPA.

Usage

CLI Options

All option are prefixed with a single -
boolean options must be passed =1
- watch=1 serve=1, etc

Name	Description	Type	Default
help	display the help message	boolean	false
jsxFactory	jsx render function to use for nodes	string	h
jsxFragment	jsx render function to use for fragments	string	Fragment
minify	minify all output	boolean	false
nomodule	generate the es2015 fallback bundle	boolean	false
port	the port to serve	number	5000
public	the directory to serve	string	public
serve	serve app locally	boolean	false
watch	one or many directories to watch for changes	boolean	false

Examples

# Build your app from src/index.js
lebeben-go src/index.js

# Build/Minify your React app from src/index.jsx
lebeben-go -minify=1 --jsxFactory="React.createElement" -jsxFragment="React.Fragment" src/index.jsx

# Watch/Serve a preact app from src/index.tsx
lebeben-go -watch=1 -serve=1 src/index.tsx

Build across platforms in bash (handled by Github Actions)

env GOOS='darwin' GOARCH='amd64' go build -o builds/lebeben-go-macos/lebeben-go .
env GOOS='windows' GOARCH='amd64' go build -o builds/lebeben-go-win64/lebeben-go.exe .
env GOOS='linux' GOARCH='amd64' go build -o builds/lebeben-go-linux/lebeben-go .

chmod +x builds/lebeben-go-macos/lebeben-go
chmod +x builds/lebeben-go-win64/lebeben-go.exe
chmod +x builds/lebeben-go-linux/lebeben-go

tar -C builds -czvf lebeben-go-macos.tar.gz lebeben-go-macos
tar -C builds -czvf lebeben-go-win64.tar.gz lebeben-go-win64
tar -C builds -czvf lebeben-go-linux.tar.gz lebeben-go-linux

Development/Release Process

npm i
make changes, rebuilt, test, etc
bump the version in package.json and package-lock.json
git add .
git commit -m "messages"
- precommit hooks will format go and js files
git tag vX.Y.Z
- make note of the leading v
- should match the version in package.json
git push origin master --tags
wait for github actions to
- build the go binaries for mac, linux, and windows
- create a release on Github
- publish a new version to npm, pointing to that release

Performance

Comparison between the native javascript version, version pulled from go get and the version installed via npm. 30 rebuilds triggered by saving a single watched file, saving roughly every 250ms. The average of the 30 builds is shown below.