# Changelog (https://docs.salla.dev/twilight/react/changelog)



Read this to see what changed in the theme engine and these docs. The newest release is at the top.

## React themes launch [#react-themes-launch]

**15 October 2026**

Twilight themes are now built with React. This release replaces the Twig engine, and these docs replace the Twig docs.

<Callout type="warn" title="Move your theme by the end of November 2026">
  Every theme must move to React by the end of November 2026. Start with the [Quick start](https://docs.salla.dev/twilight/react/start/quick-start), then use the table below to find where each Twig part went.
</Callout>

### What changed from Twig [#what-changed-from-twig]

| In Twig                                                | In React                                                       | Read                                                                                                   |
| ------------------------------------------------------ | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `.twig` templates in `src/views`                       | React components and route files in `app/`                     | [Project structure](https://docs.salla.dev/twilight/react/start/project-structure), [Routes and pages](https://docs.salla.dev/twilight/react/guide/routes-and-pages)             |
| Page variables such as `product` and `cart`            | Route loaders and the typed API client                         | [Loading data](https://docs.salla.dev/twilight/react/guide/loading-data), [API client](https://docs.salla.dev/twilight/react/api)                                                |
| Filters and helpers (`money`, `trans`, `link`)         | Hooks and components: `useMoney`, `useTranslation`, `Link`     | [`useMoney`](https://docs.salla.dev/twilight/react/hooks/use-money), [`useTranslation`](https://docs.salla.dev/twilight/react/hooks/use-translation), [`Link`](https://docs.salla.dev/twilight/react/components/link) |
| Template hooks: `{% hook 'cart:items.start' %}`        | Slots: `<HookSlot>` and `hookRegistry`                         | [Twig hook names](https://docs.salla.dev/twilight/react/slots/from-twig), [Hooks and slots](https://docs.salla.dev/twilight/react/guide/hooks-and-slots)                         |
| Home components in `views/components/home`             | React components registered for each block                     | [Add a home block](https://docs.salla.dev/twilight/react/recipes/add-a-home-block), [Built-in home blocks](https://docs.salla.dev/twilight/react/components/home-blocks)         |
| Nested locale files                                    | Flat keys in `locales/ar.json` and `locales/en.json`           | [Languages and RTL](https://docs.salla.dev/twilight/react/guide/languages-and-rtl)                                                          |
| webpack                                                | Vite with the `twilightReact()` plugin                         | [Vite plugin](https://docs.salla.dev/twilight/react/local-development/vite-plugin)                                                          |
| `salla-*` web components and their Tailwind class list | The same components, with React wrappers and their own CSS     | [Web components](https://docs.salla.dev/twilight/react/web-components), [Style web components](https://docs.salla.dev/twilight/react/guide/style-web-components)                 |
| The Twilight JS SDK                                    | The same SDK, started by the engine for you                    | [SDK](https://docs.salla.dev/twilight/react/sdk)                                                                                            |
| Component hooks (`Salla.hooks`)                        | Unchanged                                                      | [Component hooks](https://docs.salla.dev/twilight/react/sdk/component-hooks)                                                                |
| Starter theme Raed (Twig)                              | [Raed for React](https://github.com/SallaApp/theme-raed-react) | [Quick start](https://docs.salla.dev/twilight/react/start/quick-start)                                                                      |

### What stayed the same [#what-stayed-the-same]

* **`twilight.json`** still holds your settings, home blocks and features. See [twilight.json](https://docs.salla.dev/twilight/react/guide/twilight-json).
* **The Salla CLI** still creates, previews and publishes your theme. See [Local development](https://docs.salla.dev/twilight/react/local-development).
* **The Partners Portal**, its listing and the review rules. See [Partners Portal](https://docs.salla.dev/twilight/react/local-development/partners-portal) and [Review requirements](https://docs.salla.dev/twilight/react/local-development/review-requirements).
* **Merchants** set up the store the same way: the theme editor, the home blocks and the settings work as before.

### New in React [#new-in-react]

* Pages render on the server first, then run in the browser, so the first view is fast and search engines see full pages. See [How it works](https://docs.salla.dev/twilight/react/start/how-it-works).
* Every engine route can be kept as it is or taken over file by file. See [Fork a built-in route](https://docs.salla.dev/twilight/react/recipes/fork-a-built-in-route).
* Typed data for the store, products, cart and customer. See [Data](https://docs.salla.dev/twilight/react/data).
* Tools to build with an AI assistant. See [Build with AI](https://docs.salla.dev/twilight/react/start/build-with-ai).
