Revision History

The feature-u project adheres to Semantic Versioning. Each release is documented on this page (in addition to the Github Release Notes), and contains migration instructions.

Build Status Codacy Badge Codacy Badge Known Vulnerabilities NPM Version Badge

Versioned Docs

feature-u maintains version-specific documentation for all of it's releases (linked below) ... ex: This allows you to match the correct documentation to the specific version you are using. For your convenience the base will always reference the most current release.


Release What When
v2.1.0 appInit() Life Cycle Hook July 19, 2019
v2.0.0 React Hooks May 10, 2019
v1.0.1 Docs Update September 5, 2018
v1.0.0 UI Composition August 14, 2018
v0.1.3 Establish Polyfill Strategy July 2, 2018
v0.1.0 Initial Release March 6, 2018


v2.1.0 - appInit() Life Cycle Hook (July 19, 2019)

Full DocsGitHub ReleaseGitHub ContentDiff

NOTE: This release is a non-breaking change (i.e. no prior API was impacted).

  1. Added: A new Feature.appInit() Application Life Cycle Hook was added, supporting blocking async initialization.

  2. Added: In support of Feature.appInit(), the showStatus() optional callback parameter was added to launchApp() allowing the application domain to communicate blocking "persistent" status messages to the end user.

  3. Docs: Documentation improvements include:

v2.0.0 - React Hooks (May 10, 2019)

Full DocsGitHub ReleaseGitHub ContentDiff

NOTE: This release is a non-breaking change (i.e. no prior API was impacted). A major V2 version bump strictly reflects the significance of this hooks enhancement.

  1. Added: The useFassets() function has been added in support of React Hooks, providing functional component access to the Fassets object. This is an alternative to accessing fassets through Higher Order Components (using: withFassets()).

    This greatly simplifies the UI implementation, and can be seen in action in the eatery-nod-w project (see the React Hooks section).

  2. Fixed: React Component validation has been shored up by using the react-is package.

    This impacts components passed to the withFassets() API, and the fassetValidations.comp validation utility.

    Background: As of react-redux V7, connect() returns a React.memo() component type, which is an object and NOT a function ... breaking feature-u's prior component validation.

  3. Docs: Documentation improvements include:

    • Improved the concepts and feature-segregation diagrams.

    • Added a fundamental artifacts introduction to the Benefits chapter.

  4. Internal: Docs generation now uses the formal folding-menu gitbook plugin

v1.0.1 - Docs Update (September 5, 2018)

Full DocsGitHub ReleaseGitHub ContentDiff

NOTE: This release is a non-breaking change (i.e. no API was affected).

  1. Docs: Documentation improvements include:

    • The Basic Concepts chapter has been completely re-written to fully introduce you to all feature-u concepts and terminology.

      Diagrams are used to put everything in perspective ("with circles and arrows and a paragraph on the back of each one explaining what each one was to be used as evidence against us" ... Arlo Guthrie – Alice's Restaurant).

      This is a must read to get you "up to speed" quickly!

    • All diagrams are now styled to be visible in all themes (including dark mode).

    • All code samples utilize a feature.js module (previously index.js).

    • The src/app.js sample (found in Launching Your Application), has been streamlined.

  2. Added: A new assertNoRootAppElm() convenience function has been added (see: Injecting DOM Content).

v1.0.0 - UI Composition (August 14, 2018)

Full DocsGitHub ReleaseGitHub ContentDiffMigration Notes

NOTE: This release contains breaking changes from prior releases. A retrofit of client code is necessary (see the Migration Notes link above).

  1. Review: New UI Composition

    Beginning with feature-u V1 Cross Feature Communication has been completely re-designed to include UI Composition as a core offering of feature-u (thanks @jeffbski for the design collaboration)!

    • This refactor promotes one solution for all Cross Feature Communication (i.e. Actions, Selectors, UI Components, API, etc.), making it comprehensive and universal.

    • This is an extremely powerful enhancement, and even extends to things like Feature Based Routes.

    • It represents a significant step forward in providing seamless feature-based development!

    At a high level, the following items have been impacted (more detail can be found at Cross Feature Communication):

    • In an effort to standardize terminology (and remove ambiguity), the term fassets (feature assets) is being used throughout, replacing publicFace (on the aspect definition side) and app (on the usage side).

    • The Feature.fassets aspect replaces Feature.publicFace, providing a more formal set of directives, supporting things like contractual arrangements (of usage and definition), and validation of resources.

    • The fassets object replaces the app object, to programmatically access cross-feature resources.

    • The managedExpansion() function has been renamed to expandWithFassets().

    • The new withFassets() higher-order component (HOC) auto-wires named feature assets as component properties.

    In addition, if you are using any of the feature-u extended aspect plugins, you must install the latest version, as they now pass through the new fassets object.

  2. Docs: Documentation improvements include:

    • The docs have been enhanced in several areas, including API clarifications, improved cross-navigation between API/Guide, additional points of interest, examples, etc. Take a peek (always improving).

    • Several diagrams have been added to the docs. You know what they say: "a picture is worth a thousand words"!

    • Our docs now employ a dynamic left-nav menu, that only exposes sub-sections of the active section. As a result, we now promote more left-nav sub-section links, improving the visualization of "where you are at" in larger topics.

v0.1.3 - Establish Polyfill Strategy (July 2, 2018)

Full DocsGitHub ReleaseGitHub ContentDiff

NOTE: This release is a non-breaking change (i.e. no API was affected).

  1. Review: A new policy is in affect where polyfills are the responsibility of the client app, when the target JavaScript engine is inadequate (such as the IE browser). Please refer to Potential Need for Polyfills for more information.

    As a result, all previous code patches related to es2015+ polyfill issues were removed, in favor of polyfilling at the app-level.

  2. Internal: The most current babel version/configuration is now used to transpile the library's es5 distribution.

  3. Internal: The most current docs version/configuration (i.e. GitBook, JSDoc) is now used to generate our documentation.

v0.1.0 - Initial Release (March 6, 2018)

Full DocsGitHub ReleaseGitHub Content

This is where it all began ...

  1. Holy Guacamole Batman! ... This commit has no parents!!

results matching ""

    No results matching ""