Principles

• performance

  • don't invoke render all over the place

• composability

  • use HTML imports

• framework lock-in

• readability

  • use ES6 classes
  • follow conventions across all components ie:
    • attachedCallback() first
    • render() near the bottom
    • name your class CaXXXXElement
    • etc

• maintainability

  • use HTML imports

• ease of use on projects

  • use HTML imports
  • code executed must be recognisable to the developer
  • prefer no build step necessary in development

• good tooling/IDE support

  • keep CSS and HTML out of strings where possible