Registry / web-framework / babel-preset-rax

babel-preset-rax

library1.0.0-beta.0jsnpmunverified

Babel preset for compiling JSX in Rax applications, a React-like framework for cross-platform development (web, mini-programs, etc.). Current stable version is 1.0.0-beta.0, though later beta releases exist (e.g., 1.2.2). It includes plugins for JSX syntax, transformation, and display name, with optional development plugins for JSX self/source. Rax is maintained by Alibaba and focuses on performance and universal rendering. Key differentiator: tailored for Rax's custom JSX pragma (e.g., 'createElement' or 'dom') and fragment handling, with throwIfNamespace control.

web-framework

npm install babel-preset-rax

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · BABEL-PRESET-RAX

babel-preset-rax

web-frameworkjavascriptv1.0.0-beta.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default preset

✓ module.exports = { presets: ['babel-preset-rax'] }

✗ import babelPresetRax from 'babel-preset-rax'

This package is a Babel preset, not a JavaScript module — use it in Babel config files, not direct imports.

preset with options

✓ module.exports = { presets: [['babel-preset-rax', { pragma: 'dom' }]] }

✗ require('babel-preset-rax')({ pragma: 'dom' })

Options are passed as an array to the preset key in Babel config, not by calling a function.

env-specific development

✓ module.exports = { presets: [['babel-preset-rax', { development: process.env.NODE_ENV === 'development' }]] }

✗ module.exports = { presets: [['babel-preset-rax', { development: true }]], env: { development: { presets: [['babel-preset-rax', { development: true }]] } } }

Using the env option is deprecated; set development conditionally in the preset options directly.

Setup Babel with babel-preset-rax to transpile JSX in a Rax project, showing configuration and CLI usage.

// Install: npm install --save-dev babel-preset-rax @babel/core @babel/cli // Create .babelrc { "presets": [ ["babel-preset-rax", { "pragma": "createElement", "pragmaFrag": "Fragment", "throwIfNamespace": false }] ] } // Input: index.jsx function App() { return <div>Hello Rax</div>; } // Run: npx babel index.jsx --out-file index.js // Output: transformed JS without JSX.

Debug

Known issues

breakingVersion 1.0.0-beta.0 is a beta; later releases (1.2.2) may have breaking changes in plugin compatibility or defaults.

fix

Use latest version (npm install babel-preset-rax@latest) and check changelog for breaking changes.

affects: 1.0.0-beta.0

deprecatedUsing the env option in .babelrc for development presets is deprecated; pass options programmatically.

fix

Set development flag via JS config: { presets: [['babel-preset-rax', { development: process.env.NODE_ENV === 'development' }]] }

affects: >=1.0.0

gotchaThe default pragma is 'createElement', not 'React.createElement'. Forgetting to set pragma can cause missing createElement errors.

fix

Set pragma to 'createElement' (or 'dom' for Rax DOM) in preset options.

affects: >=1.0.0

gotchathrowIfNamespace defaults to true; using XML namespaces (e.g., <f:image/>) will throw an error unless disabled.

fix

Set throwIfNamespace to false in options if XML namespaced tags are needed.

affects: >=1.0.0

deprecatedPackage may not be actively maintained; last release 2020, and Rax ecosystem may have moved to other tools.

fix

Evaluate if babel-preset-rax is still necessary; consider using @babel/preset-react with custom pragma.

affects: all

Errors

Common errors & fixes

Error: Requires Babel "^7.0.0-0", but was loaded with "6.26.3"

Babel version mismatch: babel-preset-rax requires Babel 7, but Babel 6 is installed.

fix

Upgrade to Babel 7: npm install @babel/core @babel/cli --save-dev

SyntaxError: Unexpected token <

JSX syntax is not being transformed because babel-preset-rax is not configured correctly or missing from presets.

fix

Ensure .babelrc or babel.config.js includes 'babel-preset-rax' in presets and that Babel is run on the file.

ReferenceError: createElement is not defined

The default pragma 'createElement' is not imported; Rax createElement must be in scope.

fix

Add import { createElement } from 'rax'; at the top of your file, or change pragma to 'rax.createElement'.

Upgrade

Version history

1.0.0-beta.0latest on npm

Audit

Dependencies

@babel/plugin-syntax-jsxrequiredRequired for parsing JSX syntax

@babel/plugin-transform-react-jsxrequiredTransforms JSX into Rax createElement calls

@babel/plugin-transform-react-display-namerequiredAdds displayName to components for debugging

Agent activity

10 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/alibaba/rax ↗

packagehttps://www.npmjs.com/package/babel-preset-rax ↗

homepagehttps://rax.js.org ↗