# FratmScript

> FratmScript is JavaScript with Neapolitan keywords: `chist è` for const, `facc` for function, `piglie` for return, `stamm a dì` for console.log. A Rust compiler turns `.fratm` files into plain modern JavaScript (ES modules) for Node.js and browsers. Version 0.14.0.

Only the keywords change: operators, literals and every JavaScript built-in stay the same. JavaScript keywords such as `const`, `function`, `return`, `if`, `new`, `this` or `true` are not valid FratmScript. Read the full reference before writing code, then check or run it with the `fratm` CLI or its MCP server and fix it from the errors (Neapolitan message, line, column and hint).

Web apps: `.fratm` files take JSX with Neapolitan HTML tags and attributes (`<cascett>` is `div`, `<citofono quanno-tuocche={f}>` is `<button onClick={f}>`, `classe` is `className`), CSS in Neapolitan with the `stile` template tag (`culore: russo` is `color: red`), Tailwind CSS classes, and SQL in Neapolitan with GomorraSQL. `fratm nuovo app --tailwind` or `npm create fratm@latest app` starts a React + Vite project, `--completa` adds a Hono API on SQLite. Everything is translated at compile time, so the page has standard HTML and CSS.

## Docs

- [Full reference for LLMs](https://fratmscript.kkratter.com/llms-full.txt): keywords, rules that differ from JavaScript, examples for every construct, error glossary, CLI and MCP usage, and the guide's runnable examples
- [Keyword map](https://fratmscript.kkratter.com/keywords.json): every FratmScript keyword with its JavaScript equivalent, as JSON
- [README](https://github.com/kkratterf/fratmscript#readme): install, CLI commands, complete syntax

## Tools

- [Install the CLI](https://github.com/kkratterf/fratmscript#install): `curl -fsSL https://raw.githubusercontent.com/kkratterf/fratmscript/main/install.sh | sh`, or `cargo install --git https://github.com/kkratterf/fratmscript fratm-cli`
- MCP server: `fratm mcp` (stdio) with tools fratm_reference, fratm_check, fratm_compile, fratm_run, fratm_format, fratm_gomorra (SQL), fratm_stile (CSS), fratm_nuovo (files of a new project); Claude Code: `claude mcp add fratm -- fratm mcp`
- [Claude Code plugin with a FratmScript skill](https://github.com/kkratterf/fratmscript/tree/main/packages/agent-plugin): `/plugin marketplace add kkratterf/fratmscript` then `/plugin install fratmscript@fratmscript`
- CLI for scripts: `fratm check --json`, `fratm build --json`, `fratm lancia --json --timeout 10 -` (reads stdin), `fratm guida` prints the reference

## Optional

- [Playground](https://fratmscript.kkratter.com/): editor in the browser, with a guide (https://fratmscript.kkratter.com/#guida) and a 12-lesson tour
- [Guide as web pages](https://fratmscript.kkratter.com/en/guide/): one page per topic, also in Italian (https://fratmscript.kkratter.com/guida/)
- [Example programs](https://github.com/kkratterf/fratmscript/tree/main/examples)
- [npm package](https://github.com/kkratterf/fratmscript/tree/main/packages/fratmscript): `compile(source)` in JavaScript, Vite plugin, `<script type="text/fratmscript">`