PkgFoundry
Catalog npm
Back to packageRELEASE DETAILS

1.4.9

npm

@0x4447/avocado

🥑 build the output of a front-end page to be hosted on S3 and delivered by CloudFront

0x4447awsbuildclicloudfrontconvertnodejss3
Published30 Sept 2018
Direct dependencies6
Transitive dependenciesNot calculated

README

Current package documentation

🥑 Avocado

After having created the useful 0x4447 Potato 🥔 CLI, we found that deploying a simple HTML page to AWS CloudFront, a page that is not build around a framework, is annoying and time consuming. This is why we came up with the idea for Avocado: a CLI that will build the final page out of a simple folder structure by using the awesome templating engine–Hogan.

How to Install

] sudo npm install -g @0x4447/avocado

How to Use

] avocado -s PATH_TO_FOLDER

Where to get Help

] avocado -h

What to Expect

  • Removes the _preview and _output folder, this way we have a clean slate.
  • Creates empty _preview and _output folder.
  • Reads the JSON files from the data folder.
  • Reads the JSON files from the env.json file.
  • Merge the two data sets together.
  • Renders the final page using Hogan.
  • Save the result in the _preview and _output folder.

Folder Structure of the Source Site

The root folder will contain the _input folder where the content of the site is located. The data, and views folders holds the data and the HTML files which are used to generate the previews and final output.

  • Root
  • _input/
    • assets/ - all your images, js, css and other.
    • data/ - JSON files for each page from the view folder to enrich the page using Hogan.
    • views/ - all pages in HTML form which can be organized using sub folders.
    • any file to be included in the final page.
  • env.json - a JSON file that holds the environment variables that are uniquer per page deployment, and should not committed to the repository. Worth knowing: use the help option to find out how to pass different env file.

If you'd like to try out Avocado, you can take a look at our company website repository for reference.

How to deliver the site locally

If you have just a single page it is easy to check the page by opening the individual HTML file. But if you'd like to have a local setup with a custom local domain and a self signed SSL cert, you can check our configuration that we use.

Companion Software

This CLI tools works well also with the following software:

  • Potato: it helps you host and upload your work on to AWS S3 and deliver the site through AWS CloudFront.
  • Broccoli: it helps you create a Nginx configuration to work one the site from your local machine.

The End

If you enjoyed this project, please consider giving it a 🌟. And check out our 0x4447 GitHub account, where we have additional resources that you might find useful or interesting.

Sponsor 🎊

This project is brought to you by 0x4447 LLC, a software company specializing in build custom solutions on top of AWS. Find out more by following this link: https://0x4447.com or, say hello@0x4447.email.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 6

Native requirements
6 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
commander
Environment
{
  "local_name": "commander",
  "alias": false,
  "peer_metadata": null
}
2.15.1runtime
hogan.js
Environment
{
  "local_name": "hogan.js",
  "alias": false,
  "peer_metadata": null
}
3.0.2runtime
mocha
Environment
{
  "local_name": "mocha",
  "alias": false,
  "peer_metadata": null
}
5.1.0runtime
ncp
Environment
{
  "local_name": "ncp",
  "alias": false,
  "peer_metadata": null
}
2.0.0runtime
recursive-readdir
Environment
{
  "local_name": "recursive-readdir",
  "alias": false,
  "peer_metadata": null
}
2.2.2runtime
rimraf
Environment
{
  "local_name": "rimraf",
  "alias": false,
  "peer_metadata": null
}
2.6.2runtime

Distribution files

1 collected
Distribution 1

Source distribution

Source file
Checksums from source
{
  "integrity": "sha512-t7MVC/bE7U+D7aUNbbFPi0o3MJi6BM4pBBkO/1pFkgMsbDGLRkQNWC4+cxQx4JafGc3aTQ4tX3zw/k73Zr+aOw==",
  "shasum": "543fd71a8ee0215a3a58ac11a4bc950a8e249350",
  "tarball": "https://registry.npmjs.org/@0x4447/avocado/-/avocado-1.4.9.tgz",
  "fileCount": 13,
  "unpackedSize": 26960,
  "npm-signature": "-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJbsSieCRA9TVsSAnZWagAA/hkQAJa/2WDtuJAV2cclazMX\nB6C2+O0g76aTldtTkMIVWcRLhohThx1OhoMdMBxbzgzLp1dpz9YCyIqAw80A\nZ6S6gs80NSCcCVWkbWmneIcexdU1cycZ0DEoNZwa7YxHd/wJsLHnL0RWdYju\nLC1Gm/Qw+DQDaOjhxRtGGOkpLGaNldBqMVIb9zK0CFLXB5bjFiK452r27pti\np/V12OVy9m7w8ZtvmwmkZORFEztxAX9DIfhgiz2pdCX636oR0pu2kbY2tFQN\nuFmb0tC5wEaRpJjk3G5+rhNL8pKo9z+F7MwFBcQd2XBiCNll0UAJ/7/0zyfX\nqB9q4wzjs5bxciZhkMfuuW37o/kuyM08UQKzV1Zib0axTgQNDfJFkoiNTItX\n+hMkR5S7EQ//xkhPcqi8wAkr67wkbdq+31lXUAEj03qGvYHNJtN8d5ihSBVw\nCrNbnZyn7d+vY5ahL6zTTwJkRgEvntDYfNdjiH3nokhOUQYkOqlavjUF0/+d\nam9K+2BYMPAc5n/M1iEnFYZ9Ds5Te2xYOu4XCo7gXmuT0HXSvXYgwWIBEs+B\nszEOyXfLZasHC7fGzJOUr7Eni5ZkhH88Vrua8SN7a1GuGBI2Qa+eHnEf16jz\nuBe/McnK9t5qk84hKYaL+rB1vVPizMeAzRzMRKQl+QcyfAmBnSgooJC0HNNg\n5dUC\r\n=NBz/\r\n-----END PGP SIGNATURE-----\r\n",
  "signatures": [
    {
      "keyid": "SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA",
      "sig": "MEUCIALjFhRWs7+RgJQc/Rf4o8DPlSR/5xeSUma/KY0U+y5YAiEA0W2lrkumy9eB7GVxLz4nShrfJHmDGKIBHrMgo7VY0+Q="
    }
  ]
}

Repository

PENDING
0x4447/0x4447-cli-node-avocado

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 22:35 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:aa5edfd2e8ec829da19236be42e455dc9c1eafbe4eb454035aeeffba8fa62f09

Other collected versions

1.8.131 Mar1.8.09 Mar1.7.08 Feb1.6.113 Jan1.6.09 Dec1.5.32 DecView all collected versions →