marcodpt/app

A minimalistic hyperscript framework

Paw

A minimalistic hyperscript framework.

Demo

Features ❤️

• Theme builder
• Built-in router
• SPA with SSR index.html optimized for SEO
• No build steps
• No vDom
• Stop the nonsense of rewriting any JS library for a framework!
• JSON Schema based forms
• HTML to Hyperscript converter
• Table data with great flexibility
• Graph
• Chart
• Barcode
• Maps

Motivation 📢

Why are JS frameworks bad?

Frameworks like:

• react
• vue
• angular
• svelte
• qwik
• hyperapp

suffer from the same problem.

We can argue that vDom is slow so svelte solves the problem by compiling javascript in the build steps.

We can argue that the frameworks are heavy and svelte solves the problem again, qwik only loads js on demand, and hyperapp is too minimalistic.

We can argue that build steps are unecessary complication and hyperapp is the clear winner here.

But this is getting away from the central problem with these approaches, which they ALL suffer from.

The problem is that frameworks need to control JavaScript centrally in the elements and/or components that are used.

This implies that the code of a library external to the framework must be rewritten.

See for example the number of existing Bootstrap javascript implementations:

• react-bootstrap
• bootstrap-vue
• ng-bootstrap
• sveltestrap

These projects exist for the reason that vDom and the implementation of a component library conflict.

If you need a less popular external library and/or use a framework with a smaller community, you will have to reimplement javascript or wait for someone to do it with all the difficulties and bugs involved.

Why web components are bad?

Libraries like Shoelace allow you to use reactive components within these frameworks without having to be reimplemented.

The problem is data exchange, two way data binding needs to be implemented individually for each framework.

Components written in HTML do not have the good parts of these vDom frameworks that allow you to easily pass objects, arrays and functions to them, greatly limiting their capacity and making the API difficult.

Why I build this project?

I wanted to have components with all the capabilities of javascript frameworks (passing objects, arrays and functions).

And have a simplified interface to access work done in libraries like Bootstrap without having to reimplement javascript.

The fact that using hyperscript allows you to encapsulate the logic of the components in small modules that make the weight of the vDom unnecessary.

I didn't want to have to deal with the complications of build steps.

And I wanted the libraries I used to only be loaded when called (using es6 modules or dynamically adding the script to the page).

And to achieve good SEO, produce an SSR home page with the customization options that exist in the open source world.

I didn't find anything on github or google that went this route, so I created it.

TODO 🔧

• dynamic tests implementation

• separate router and data-paw as a plugin

• make a bundled and minified version available

• put a hello world in the documentation and in the generated index.html

• datalist do not work on firefox mobile

• semantic html tests, no string cmp

• formatter should be a component?

• allow icon with input to avoid unicode and translation

• separate input and output options

• allow to see other tests variants

• dynamic validation with functions

• input wrapper review

• remove or minimize lang support

• remove non bootstrap options support, minimize options and review settings

• separate outputs

• remove whitespace for pre tag

• external links simbol and remove data-paw-path

• copy features to home article and allow to edit it

• better array ctrl support (minimize, up, down, remove, add)

• deep router param is an array (?, +, *) support at the end of var

• allow icon, title and description in navbar and sidebar

• finish documentation

• finish static tests

• finish dynamic tests

Contributing 🤝

It's a very simple project. Any contribution, any feedback is greatly appreciated.

Support ⭐

If this project was useful to you, consider giving it a star on github, it's a way to increase evidence and attract more contributors.

Acknowledgment 🙏

This work would not be possible if it were not for these related projects:

• FontAwesome
• Bootstrap
• Bootswatch
• JSON Schema
• HTML5 Boilerplate
• highlight.js
• Cytoscape.js
• Chart.js
• JsBarcode
• Leaflet
• QUnit
• FontIcon
• bundlejs

A huge thank you to all the people who contributed to these projects.