Simply JSX

0.0.3 verified Fri May 01 auth: no javascript

A lightweight transpiler for JSX that does not require React. Version 0.0.3 is the latest stable release, which is essentially an early-stage proof-of-concept with no active development cadence. It transpiles JSX to JavaScript using a simple configuration file and includes a file watcher for auto-reloading in the browser. This tool is minimally viable, lacking TypeScript types, extensive testing, or community adoption. It differentiates from Babel by targeting a simpler, zero-config setup for non-React JSX usage.

Common errors

error Error: Cannot find module 'simply-jsx' ↓

cause Package not installed or version mismatch.

fix

Run 'npm install simply-jsx@0.0.3' in project root.

error ENOENT: no such file or directory, open 'simply.json' ↓

cause Missing simply.json configuration file.

fix

Create simply.json in project root with required fields.

error Error: JSX element 'div' is not defined ↓

cause JSX is transpiled but runtime expects createElement function; not provided.

fix

Ensure your output includes a polyfill for createElement, or provide one manually.

Warnings

breaking Package is extremely early-stage (v0.0.3). API may change without notice; no stable release. ↓

fix Pin to a specific version and expect breaking changes.

gotcha simply-jsx requires a simply.json configuration file; without it the CLI fails. ↓

fix Create simply.json in project root with required fields: source, build, staticFiles.

gotcha The package has no TypeScript types; usage in TypeScript projects requires manual type definitions. ↓

fix Add type declarations or use with // @ts-nocheck

deprecated No documentation on exported functions; CLI may be the only intended interface. ↓

fix Use the CLI tool (npm start) instead of programmatic API.

breaking Does not support JSX with React; custom createElement logic is used, incompatible with React. ↓

fix Do not use with React; intended for standalone JSX transpilation.

Install

npm install simply-jsx

yarn add simply-jsx

pnpm add simply-jsx

Imports

default
wrong
```
const simplyJsx = require('simply-jsx')
```
correct
```
import simplyJsx from 'simply-jsx'
```
Package is ESM-only since v0.0.3, but recommend checking actual exports; there may be no default export.
jsx
wrong
```
const { jsx } = require('simply-jsx')
```
correct
```
import { jsx } from 'simply-jsx'
```
Named export 'jsx' might not exist; this is a hypothetical import.
renderer
wrong
```
const render = require('simply-jsx').render
```
correct
```
import { render } from 'simply-jsx'
```
Actual named exports are undocumented; this entry is speculative based on typical patterns.

Quickstart

Demonstrates minimal setup: install the package, configure simply.json, create an HTML file, and run the transpiler.

// Ensure package is installed: npm install simply-jsx@0.0.3
// Create simply.json in project root with:
// { "source": "src", "build": "dist", "staticFiles": "public" }
// Create public/index.html with a root element
// Then run: npx simply-jsx
// Write a component in src/App.jsx:
export default function App() {
  return <div>Hello Simply JSX</div>;
}