platformjs-core
Advanced tools
convention-based platform for custom Express + Handlebars + Mongoose + Passport + Bootstrap sites
TR;DL: Platform for building custom Express + Handlebars + Mongoose + Passport + Bootstrap sites quickly.
A server-side node module that utilizes popular NPM modules and a set of simple file layout conventions to make putting together an efficient, new, custom site easy and efficient.
PlatformJS qualifies as "opinionated" software. The primary purpose of the platform is to allow tie together existing, high-quality libraries into a new site very quickly; it is quite difficult to serve this purpose effectively without making presumptions about which libraries to use.
The basic server is with no content or custom configuration isn't very interesting, however to get a minimal server going:
In a file server.js:
var platformjs = require("platformjs-core");
var platform = new platformjs.Platform;
platform.start();
Then start the server with:
$ node server.js
If you visit http://localhost:8080, you should then get a message Cannot GET /. This is correct behavior as the site has no content.
All content, customization, and plug-ins are read in from the subdirectories of a special extensions subdirectory. Within that directory, there are conventions for content -- such as the public directory being used to directly server static content:
extensions/mysite/publicindex.html with some HTML contentpublic directory within the extensionNote: if a public/favicon.ico file is located, it will automatically be special-cased to use the express favicon middleware for efficiency.
The protected/ sub-directory can be used similiarly to the public/ sub-directory, except for generated files. For example, a file named protected/user/dashboard.hb.html represents a Handlebars template that is automatically routed as a rendered template to /user/dashboard.
TBD.
Templates currently use a version of Handlebars with a few simple extensions.
Templates should end with an .hb.html extensions.
The built in extensions to the Handlebars include:
{{#markdown}}{{/markdown}} can be used to include markdown within the page.
{{#context}}{{/context}} text within this block is treated as JSON which is merged into the template context. This is useful to "locally" define variables in the template without modifying the code. This can be useful for generating tables of data or other repeated elements.
All files in the partials directory with a .hb.html are considered Handlebars partials.
For example, if there is a file partials/base-stylesheets.hb.html, it will can be inserted into another template via:
<head>
{{> base-stylesheets }}
</head>
Note: The current implementation does not support nested sub-directories within this sub-directory.
In order to control the precedent of settings that overlap between extensions, each extension is given a priority.
FAQs
convention-based platform for custom Express + Handlebars + Mongoose + Passport + Bootstrap sites
We found that platformjs-core demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
A supply chain attack on Axios introduced a malicious dependency, plain-crypto-js@4.2.1, published minutes earlier and absent from the project’s GitHub releases.
Research
Malicious versions of the Telnyx Python SDK on PyPI delivered credential-stealing malware via a multi-stage supply chain attack.
Security News
TeamPCP is partnering with ransomware group Vect to turn open source supply chain attacks on tools like Trivy and LiteLLM into large-scale ransomware operations.