pree
TypeScript icon, indicating that this package has built-in type declarations

0.2.1 • Public • Published

npm GitHub Workflow Status



A CLI that prebuilds HTML files. Use it to build websites with plain HTML, CSS and JS.

🧬 It pre-renders web components (docs),
🏗️ It handles layouting and metadata (docs),
👻 It manages build-only components and scripts (docs),
✨ It gets components and scripts access to build environment (docs).

pree view     <src>                      # 👉 preview your website
pree build    <src> <dest>               # 👉 prebuild your website

Usage

👉 Write plain HTML, CSS and JavaScript for your website. Assuming your HTML files and your assets are in src folder, preview your website:

npx pree view src

👉 And prebuild it into dest folder:

npx pree build src dest

[!IMPORTANT] 📖 Read the documentation for more info.


Credits

pree is built on top of the following open-source projects (amongst others). For a more complete list, check out the credits page.

  • puppeteer: for prebuilding pages and pre-rendering web components.
  • koa: for serving content and layouting.
  • cheerio: for manipulating HTML (e.g. layouting).
  • gray-matter: for parsing front matter.
  • chokidar: for watching files.
  • chalk: for all the colors.
  • yargs: for parsing command line arguments.
  • yaml: for parsing CLI config.

Contribution

You need node, NPM to start and git to start.

# clone the code
git clone git@github.com:loreanvictor/pree.git
# install stuff
npm i

Make sure all checks are successful on your PRs. This includes all tests passing, high code coverage, correct typings and abiding all the linting rules. The code is typed with TypeScript, Jest is used for testing and coverage reports, ESLint and TypeScript ESLint are used for linting. Subsequently, IDE integrations for TypeScript and ESLint would make your life much easier (for example, VSCode supports TypeScript out of the box and has this nice ESLint plugin), but you could also use the following commands:

# run tests
npm test
# check code coverage
npm run coverage
# run linter
npm run lint
# run type checker
npm run typecheck

Readme

Keywords

none

Package Sidebar

Install

npm i pree

Weekly Downloads

65

Version

0.2.1

License

MIT

Unpacked Size

162 kB

Total Files

215

Last publish

Collaborators

  • lorean.victor