Without noize, 1.0.0 is out.

? Reason User Change

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

? Fixes

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

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

? (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

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

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

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
• plugin-bundler-webpack: development mode is now showing "minimal" output by default
• plugin-bundler-webpack: cache is now enabled for babel-loader
• 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...

? 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!

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)

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).