Tropical Versions Save

Fast, mostly-just-HTML static sites with islands of client-side JS. Click the "Use this template" button ↖️

v11.4.2

1 year ago

Changes

  • Add missing meta and tableOfContents props that weren't being passed to pages when rendered for the JSON Feed 12a44c8962986469f319a1c945d96bec66471ec0

Diff: https://github.com/bensmithett/tropical/compare/v11.4.1...v11.4.2

Upgrade instructions (more info)

Merge upstream changes

First, configure this repo as a remote for your repo (you only need to do this once)

  git remote add template https://github.com/bensmithett/tropical.git

Then fetch & merge the latest changes, resolving any conflicts manually:

git fetch template
git merge template/main

or...

Manually update your code

Merging upstream changes should be straightforward for this change but see https://github.com/bensmithett/tropical/compare/v11.4.1...v11.4.2 for changes you can make to your project manually.

As always, open an issue if you're having trouble upgrading and I'll help you through it!

v11.4.1

1 year ago

Changes

  • Update dependencies to latest versions
  • Fix a React warning about missing key in TableOfContents

Diff: https://github.com/bensmithett/tropical/compare/v11.4.0...v11.4.1

Upgrade instructions (more info)

Merge upstream changes

First, configure this repo as a remote for your repo (you only need to do this once)

  git remote add template https://github.com/bensmithett/tropical.git

Then fetch & merge the latest changes, resolving any conflicts manually:

git fetch template
git merge template/main

or...

Manually update your code

Merging upstream changes should be straightforward for this change but see https://github.com/bensmithett/tropical/compare/v11.4.0...v11.4.1 for changes you can make to your project manually.

As always, open an issue if you're having trouble upgrading and I'll help you through it!

v11.4.0

1 year ago

Changes

  • Extract a table of contents from MDX pages (based on heading slugs)
    • Add @stefanprobst/rehype-extract-toc Rehype plugin and configure in Vite config
    • Update entry-server.jsx to pass extracted tableOfContents data as props to Layout and Page components
    • Add a very basic <TableOfContents> component & stories

Diff: #52

Upgrade instructions (more info)

Merge upstream changes

First, configure this repo as a remote for your repo (you only need to do this once)

  git remote add template https://github.com/bensmithett/tropical.git

Then fetch & merge the latest changes, resolving any conflicts manually:

git fetch template
git merge template/main

or...

Manually update your code

Merging upstream changes should be straightforward for this change but see https://github.com/bensmithett/tropical/compare/v11.3.0...v11.4.0 for changes you can make to your project manually.

As always, open an issue if you're having trouble upgrading and I'll help you through it!

v11.3.0

1 year ago

Changes

Diff: https://github.com/bensmithett/tropical/pull/51/files

Upgrade instructions (more info)

Merge upstream changes

First, configure this repo as a remote for your repo (you only need to do this once)

  git remote add template https://github.com/bensmithett/tropical.git

Then fetch & merge the latest changes, resolving any conflicts manually:

git fetch template
git merge template/main

or...

Manually update your code

Merging upstream changes should be straightforward for this change (unless you've made lots of changes to Vite config or TropicalCodeBlock) but see https://github.com/bensmithett/tropical/compare/v11.2.0...2f0b51aadc056459ac5a8e939d83b9a92d6b32d7 for changes you can make to your project manually.

As always, open an issue if you're having trouble upgrading and I'll help you through it!

v11.2.0

1 year ago

Changes

Diff: https://github.com/bensmithett/tropical/compare/v11.1.0...a031636

  • Add and configure vite-plugin-image-presets (from Tropical's Vue-flavoured cousin îles!)
  • Add <Image> and <Picture> components that work with those preset imports

See the new Images docs for usage details.

Upgrade instructions (more info)

Merge upstream changes

First, configure this repo as a remote for your repo (you only need to do this once)

  git remote add template https://github.com/bensmithett/tropical.git

Then fetch & merge the latest changes, resolving any conflicts manually:

git fetch template
git merge template/main

or...

Manually update your code

Merging upstream changes should be straightforward for this change (unless you've made lots of changes to Vite config or TropicalCodeBlock) but see https://github.com/bensmithett/tropical/compare/v11.1.0...a031636 for changes you can make to your project manually.

As always, open an issue if you're having trouble upgrading and I'll help you through it!

v11.1.0

1 year ago

Changes

See https://github.com/bensmithett/tropical/compare/v11.0.0...c42f0be892d4bf0f0592facb643068a3da97723b

  • Add yarpm and update package scripts to call it instead of yarn
  • Rename TropicalPhotoButton to ExampleComponent
  • Fix a build script bug (it wasn't using the correct Vite config following the v11.0.0 updates)

Upgrade instructions (more info)

Merge upstream changes

First, configure this repo as a remote for your repo (you only need to do this once)

  git remote add template https://github.com/bensmithett/tropical.git

Then fetch & merge the latest changes, resolving any conflicts manually:

git fetch template
git merge template/main

or...

Manually update your code

Merging upstream changes should be straightforward for this change (unless you've made lots of changes to Vite config or TropicalCodeBlock) but see https://github.com/bensmithett/tropical/compare/v11.0.0...c42f0be892d4bf0f0592facb643068a3da97723b for changes you can make to your project manually.

As always, open an issue if you're having trouble upgrading and I'll help you through it!

v11.0.0

1 year ago

Changes

See #48

  • Upgrade dependencies
    • Vite 2.0 to 3.0
    • React 17 to 18.2
    • MDX 1.x to 2.1
  • Replace Storybook with Ladle
  • Move components/TropicalCodeBlock to components/tropical/CodeBlock
    • The next release is going to have another "batteries included" Tropical component (a responsive <Picture>). I figured I should put these in a special folder instead of mixing them in with your components.

Upgrade instructions (more info)

Merge upstream changes

First, configure this repo as a remote for your repo (you only need to do this once)

  git remote add template https://github.com/bensmithett/tropical.git

Then fetch & merge the latest changes, resolving any conflicts manually:

git fetch template
git merge template/master

or...

Manually update your code

Merging upstream changes should be straightforward for this change (unless you've made lots of changes to Vite config or TropicalCodeBlock) but see https://github.com/bensmithett/tropical/pull/48/files for changes you can make manually:

As always, open an issue if you're having trouble upgrading and I'll help you through it!

v10.2.0

2 years ago

Changes

See #45

Upgrade instructions (more info)

Merge upstream changes

First, configure this repo as a remote for your repo (you only need to do this once)

  git remote add template https://github.com/bensmithett/tropical.git

Then fetch & merge the latest changes, resolving any conflicts manually:

git fetch template
git merge template/master

or...

Manually update your code

Merging upstream changes should be easy for this change (unless you've made lots of changes to TropicalCodeBlock) but see https://github.com/bensmithett/tropical/pull/45/files for changes you can make manually:

  • yarn remove prism-react-renderer && yarn add react-syntax-highlighter
  • Update TropicalCodeBlock and entry-server.jsx as per #45
  • Add "framework": "@storybook/react" to your .storybook/main.cjs
  • Add providerImportSource: '@mdx-js/react' to both vite config files

v10.1.0

2 years ago

Changes

See #44

10.0.0 switched from a 2-step prerender (build the server bundle, then import & use it) to one step (import the Renderer directly into the prerenderer with vite.ssrLoadModule)

However as raised in #42, that meant some assets were being referenced by their original name rather than the cacheable hashed name.

This change switches back to the 2-step prerender, while keeping 10.0.0's switch to ES Modules at the project level.

Upgrade instructions (more info)

Merge upstream changes

First, configure this repo as a remote for your repo (you only need to do this once)

  git remote add template https://github.com/bensmithett/tropical.git

Then fetch & merge the latest changes, resolving any conflicts manually:

git fetch template
git merge template/master

or...

Manually update your code

Merging upstream changes should be easy for this change, but see https://github.com/bensmithett/tropical/pull/44/files for changes you can make manually:

  • Update the build and build:server scripts in package.json
  • In prerender.js, switch vite.ssrLoadModule for import and remove references to vite
  • Add the new vite.config.server.js

v10.0.1

2 years ago

Changes

Major Fela update but shouldn't require any changes to your app code. See https://github.com/robinweser/fela/releases/tag/v12.0.1 and https://weser.io/blog/introducing-fela-12

Upgrade instructions (more info)

Merge upstream changes

First, configure this repo as a remote for your repo (you only need to do this once)

  git remote add template https://github.com/bensmithett/tropical.git

Then fetch & merge the latest changes, resolving any conflicts manually:

git fetch template
git merge template/master

or...

Manually update your code

See https://github.com/bensmithett/tropical/pull/43/files, you'll need to:

  • yarn upgrade-interactive and upgrade the outdated dependencies but be careful to exclude
    • @mdx-js/mdx
    • @mdx-js/react
    • react
    • react-dom

React 18 has just been released but some Storybook dependencies need to catch up before we upgrade that.

The upgrade to MDX 2 appears to be blocked at the moment while Storybook is still dependent on MDX 1, see https://github.com/storybookjs/builder-vite/issues/234 and https://github.com/brillout/vite-plugin-mdx/issues/47