Phenomic changelog

Changelog History

• v1.0.0 Changes

  May 29, 2019

  Without noize, 1.0.0 is out.

  🍱 💥 Reason User Change

  • ⚡️ @phenomic/plugin-renderer-react: Update ReasonReact JSX to version 3
    by @arecvlohe

• v1.0.0-beta.9 Changes

  January 18, 2019

  🍱 💥 (Minor) Changes

  • 🔌 @phenomic/plugin-transform-markdown: stop converting tags case automatically
  • 🔌 @phenomic/plugin-transform-asciidoc: stop converting tags case automatically

  🍱 💪 Fixes

  • 🔌 @phenomic/plugin-collector-files: fix "draft skipped for production" feature

• v1.0.0-beta.8 Changes

  January 07, 2019

  ⚡️ Minor update to provide some fixes:

  • 🔌 @phenomic/plugin-bundler-webpack: (fix) put "react-native" as external, like react-native-web
  • @phenomic/cli: Add missing peer dep
  • 🚚 @phenomic/core: remove "bs-platform" as a core dependency

• v1.0.0-beta.7 Changes

  December 09, 2018

  🚀 Quick release for issues related with beta.6

  🍱 💥 Fixes

  • 🔌 plugin-bundler-webpack: Add missing @babel/core dependency
  • babel-preset: fix config to work even in non-static or non production

• v1.0.0-beta.6 Changes

  December 08, 2018

  Erratum

  🛠 Check out beta.7 which includes bugfixes related to this release.

  🍱 🚨 Breaking change

  • ⬆️ Upgrade from babel 6 to babel 7 (+fixup).
    ⚡️ ⚠️ If you were using phenomic without any custom babel config, this update should be transparent for you.
  • Reason users: you will night to replace *.js by *.bs.js for some files Eg:
    import { createContainer } from "@phenomic/preset-react-app/lib/es6/src/phenomicPresetReactApp.js";
    to
    import { createContainer } from "@phenomic/preset-react-app/lib/es6/src/phenomicPresetReactApp.bs.js";

  🍱 😋 Fixes

  • 🔌 plugin-bundler-webpack: Fix: Add apollo support (defined as external dependency to avoid SSR issues with in memory cache)
  • 🔌 plugin-renderer-react: Fix: provide same props for getInitialProps during SSR and CSR (pathname+params).
    We previously send too many props during SSR to getInitialProps(), different
    from CSR)
  • 🔌 plugin-renderer-react: fix issue with "class" prop generated from markdown in BodyRenderer

  🍱 👍 Improvements

  • 🏗 core: Failing URLs during static pre-rendering do not crash the entire build anymore
  • 🏗 core: Better error reporting about errors like window is not defined during static build with a tip on how to fix it
  • core: CLI output is now more sweet.
    Here is a before/after.
    
  • 🗄 core: avoid deprecated Buffer warning
  • 🚑 plugin-bundler-webpack: Hide annoying warning Critical dependency: the request of a dependency is an expression
  • ⚠ plugin-bunder-webpack: errors/warnings are now rendered using native webpack output
  • 0️⃣ plugin-bundler-webpack: development mode is now showing "minimal" output by default
  • 🔌 plugin-bundler-webpack: cache is now enabled for babel-loader
  • 0️⃣ plugin-bundler-webpack: allow config to be exported as es6 (export default)

  🥳 Internal

  • 🔨 Refactoring of webpack bundler plugin in order to prepare future SSR rendering enabled in dev mode
  • Reason code (generated as javascript) used in the core codebase (experimental)
  • Multiple other minors improvements...

• v1.0.0-beta.5 Changes

  November 26, 2018

  🍱 🚨
  ⬆️ We upgraded webpack from v3 to v4.

  🚀 So this release might be a breaking change if you use a custom webpack. If you
  👉 use webpack without custom config, you should not have any problem. Note that
  🔌 you could still use v3 webpack plugin if you don’t rely on the react-app preset
  🔌 and specifying the webpack beta.3 plugin version.

  🍱 ⚠️
  🚚 We removed react-hot-loader

  We decided to do, like CRA & Next.js, to not include react-hot-loader for now.
  Previous version of phenomic could create infinite loop in case of an error in a
  👍 react component…. It’s not stable enough & it’s not going to be better in the
  future, when React hooks will land as a stable feature.

  ---

  ⚡️ Beside this small update, we are working on a react + reason + graphql example
  🍱 😋 and also a huge improvement on the content API!

• v1.0.0-beta.4 Changes

  October 27, 2018

  This is a minor beta that only brings the following:

  • Add PHENOMIC_APP_BASEURL env variable (entire baseUrl option as a string)
    (in
    3799fa8
    by @MoOx)
  • 🔌 @phenomic/plugin-rss-feed: fail with a http 500 if rss feed fail to be
    generated (in
    26c8d95
    by @MoOx)
  • 🔧 @phenomic/plugin-bundler-webpack: Make root for App.js configurable (in
    78ecd47
    by @airtonix)
  • 🔌 @phenomic/plugin-renderer-react: fix issues with class attributes (coming
    from markdown) (in
    927aea2
    by @MoOx)
  • 🔨 Internal refactoring by @MoOx

  🚧 Website has been a WIP for a few month now, mostly due to a break @MoOx took
  from his keyboard.

  Stable 1.0.0 is missing a change for the database engine that is currently
  causing performance issues during development as soon as you get a hundred of
  pages. All efforts are currently on this improvement.

  For Reason users

  • ⬆️ Upgrade bs-platform to 4.x and reason-react to 0.5.x (in
    6067bc9,
    1e4de9a
    and
    086c0af
    by @MoOx)

• v1.0.0-beta.3 Changes

  May 24, 2018

  Hopefully, the last beta

  🚀 We are very close to our final and stable release for v1. Why we didn't ship
  🚚 this version already? Some people like to move fast & break things. But we
  wanted to have a correct design for the v1 so future majors version won't break
  too much things.

  What we did for v0.x was an experiment and we learned a lot of things by running
  this in production on moderate websites. We have spent a lot of brain energy to
  👉 make a scalable & flexible solution with a small API surface.

  We have designed an architecture that follow React way of thinking, by offering
  📦 a centralized lifecycle. With that in
  mind we have adjusted our goal and make React & Webpack, 2 core pieces of v0.x,
  🔌 first class plugins in our v1.x. This opens up lot of nice things to support
  React or Webpack alternatives.

  📚 Documentation is a work in progress 🎉

  First thing to celebrate, we started to work on our website! You can now find
  📚 documentation for the core and the
  📦 react preset tutorial! More things will
  follow!

  2 small breaking changes

  Below you will find 2 small breaking changes, very easy to adjust (that will
  probably consist of adding content in front of all your current existing query
  🔧 to our content api or to adjust your configuration).

  🍱 🚨 @phenomic/core: content options now supports multiples entries and globs
  (+
  fixup)
  by @MoOx

  All your previous queries won't work with this breaking change but don't
  worry, it's very easy to adjust your code.

  👍 We are sorry to add a breaking change now, but it's for the better.

  Solution 1 (recommended): You will have to add "content/" in front of all
  your path in your queries. Why? It's for being more explicit and also be able
  👍 to support multiples sources (multiples folders) to avoid duplicate names
  ⬆️ without a weird configuration. The upgrade is pretty easy.

  For example

  const HomeContainer = withPhenomicApi(Home, props =\> ({ posts: query({ path: "posts" }) }));
  

  Will become

  const HomeContainer = withPhenomicApi(Home, props =\> ({ posts: query({ path: "content/posts" }) }));
  

  Solution 2 (for lazy people): You can keep the previous behavior very easily
  by using this value for content option: "": {root: "content", globs: ["**/*"]}. You can throw that in your package.json in a phenomic like this:

  "phenomic": { "content": { "": {root: "content", globs: ["\*\*/\*"]} }, "presets": ["@phenomic/preset-react-app"] }
  

  🍱 🚨 @phenomic/plugin-rss-feed: now lookup in content/posts by default.
  by @MoOx

  🔧 To get previous behavior back, just use this configuration (adjust to match
  yours):

  "phenomic": { "presets": ["@phenomic/preset-react-app"], "plugins": [[ "@phenomic/plugin-rss-feed", { "feeds": { "feed.xml": { "query": { "path": "content/posts" } } } }] ] },
  

  🛠 Bugfixes

  🍱 🐛 @phenomic/plugin-renderer-react: Handle scroll like it should (to top or to the hash if any)
  by @MoOx

  🍱 🐛phenomic/plugin-collector-files: correctly clean extensions from filename for id (not only md|json but all extensions by the plugin loaded at runtime)
  by @MoOx

  Tons of small improvements

  📚 As we started to actively working on our documentation, we have added tons of
  small improvements.

  🍱 ✨ @phenomic/plugin-renderer-react: add render + callback option to createApp/renderApp for custom rendering
  by @MoOx

  This commit allows you to use a custom render() function. This way to render the
  💅 app is required by some solutions that needs a custom wrapper for styles
  🌐 pre-rendering (eg: react-native-web).

  🍱 🎉 examples/react-native-web-app
  by @MoOx

  🍱 ✨ @phenomic/core: add socketPort option (and switch to 3334 since 1415 can be used by dbstar)
  by @MoOx

  🍱 ✨@phenomic/core: Improve error shown from database access
  by @MoOx

  🍱 ✨ @phenomic/core: Improve error message from database not found entry
  by @MoOx

  🍱 🔥 Add a new helper to extract meta from body nodes (title + headings list)
  (+
  fixup)
  by @MoOx

  🔌 This helper is used in @phenomic/plugin-transform-markdown and
  @phenomic/plugin-transform-asciidoc to automatically add a title meta
  even if you don't have frontmatter. Pretty cool for files that you don't
  control. This helper also returns a list of headings in your content, which is
  pretty convenient to make a table of content at the top of you page or in a
  sidebar.

  🍱 ✨ @phenomic/plugin-transform-markdown: add title fallback extracted from markdown body if no title is in the frontmatter + add a list of markdown headings
  (+
  fixup)
  by @MoOx

  🍱 ✨ @phenomic/plugin-transform-asciidoc: add title fallback extracted from markdown body if no title is in the frontmatter + add a list of markdown headings
  (+
  fixup)
  by @MoOx

  🍱 ✨ @phenomic/plugin-transform-json: add title fallback
  by @MoOx

  🏗 ✨ @phenomic/core: better display in case of error during start/build
  by @MoOx

  🍱 ✨ @phenomic/core: add options to sort db results
  by @MoOx

  This feature is pretty awesome and allows you to add custom order to your query.
  As a good example, we wanted to sort our showcase with the following algorithm:

  • Sites with a flag curated first
  • Sites with many tags
  • Sites with tags "blog" at the end.

  In order to do so, we have introduced this option and we hope you will like it.
  You can check out the
  📚 documentation for db.sortFunctions
  and take a look to the
  one we use for the showcase.

  🍱 ✨ @phenomic/cli: add preview command
  by @MoOx

  🏗 ✨ @phenomic/core: add preview command to build & serve results
  by @MoOx

  Now you can run

  phenomic preview
  

  🏗 This will build and serve the website, to mimic production (as you will have the
  pre-rendered files and the client side reconciliation).

• v1.0.0-beta.11 Changes

  March 24, 2019

  🍱 💪 Fixes

  • 💅 @phenomic/plugin-bundler-webpack: Fix Styled components FOUC with v4
    by @Jokinen
  • Internals changes to ensure bs-platform 5 compatibility by @MoOx

• v1.0.0-beta.10 Changes

  March 15, 2019

  🚀 Minor release to add support for
  📄 React Hooks!

  🍱 💪 Fixes

  • 🔌 @phenomic/plugin-renderer-react: Add support for react hooks
    by @MoOx
  • 🚚 @phenomic/plugin-transform-asciidoc: Remove unused imports
    by @DanielRuf
  • 🔌 @phenomic/plugin-transform-asciidoc: fix tags spacing according to markdown behavior, for consitency accross format
    by @MoOx
  • 📄 various minor docs improvements by @MoOx, @drazik & @nalanirojas25