Download Latest Version 1.22 source code.tar.gz (1.9 MB)
Email in envelope

Get an email when there's a new version of organice

Home / 1.2
Name Modified Size InfoDownloads / Week
Parent folder
1.2 Switch to Parcel _ Fix Upgrade Issues source code.tar.gz 2025-04-12 1.9 MB
0
1.2 Switch to Parcel _ Fix Upgrade Issues source code.zip 2025-04-12 2.0 MB
0
README.md 2025-04-12 9.5 kB
0
Totals: 3 Items   3.9 MB 0

Important Update Information: One-Time Action May Be Required

Due to an issue introduced during the previous upgrade from CRA v3 to v4, some users may have been stuck on an older version of organice, particularly if using it as a PWA (Home Screen App on iOS). This release fixes that underlying caching problem.

To ensure you receive this update and future ones correctly, you might need to perform a one-time manual action:

  • iOS Home Screen App (PWA) Users: Please delete the existing organice bookmark/icon from your home screen and then re-install it by visiting the site in Safari and using "Add to Home Screen".
  • Other Browser Users: A hard refresh (e.g., Ctrl+Shift+R or Cmd+Shift+R) might be necessary to clear the old cached version.

After performing this one-time action, future updates should load automatically as expected.

—

Switch from Create React App (CRA) to Parcel

This release marks a significant internal change: we have migrated our build tooling from Create React App (CRA) to Parcel.

Motivation:

Create React App, our previous build tool, has reached its End-of-Life (EOL) as announced by the React team (https://react.dev/blog/2025/02/14/sunsetting-create-react-app). This migration ensures the project remains maintainable and utilizes modern tooling.

Decision:

We chose Parcel (https://parceljs.org/), a zero-configuration web application bundler. The migration largely followed the official guide (https://parceljs.org/migration/cra/).

Key Changes & Benefits:

  • /Modern Tooling:* Replaces the EOL CRA with an actively maintained build tool.
  • /Future Upgrade Reliability:* Fixes the critical bug mentioned above, ensuring smoother updates going forward.
  • /Simplified Build:* Reduces complexity by leveraging Parcel's built-in features.
    • /SCSS Handling:* Integrated Sass/SCSS support allowed the removal of custom build logic (see commit 26fc36d0).
    • /Improved Dev Experience:* Assets like changelog files can now be updated and reloaded during development without restarting the server.
  • /Testing Adjustments:* Since Parcel doesn't manage Jest configuration like CRA did, the Jest setup was "ejected" and is now managed manually via configuration files (babel.config.json, jest.config.json, etc.) (see commit b171dcca).
  • /Other Refinements:* Minor adjustments were made to how SVGs are handled in JSX, the service worker implementation, and the manifest file to align with Parcel's conventions.

This work was done in Pull Request [#1014] and [#1015].

For more detailed context on the decision and its consequences, please refer to ADR-004: Using Parcel in our wiki.

What's Changed

New Contributors

Full Changelog: https://github.com/200ok-ch/organice/compare/1.1.1...1.2

Source: README.md, updated 2025-04-12