https://github.com/fxhxyz4/gulp-racket
RacketScript transformer plugin from racket -> javascript using racketscript
https://github.com/fxhxyz4/gulp-racket
gulp-plugin racket-lang racketscript
Last synced: about 2 months ago
JSON representation
RacketScript transformer plugin from racket -> javascript using racketscript
- Host: GitHub
- URL: https://github.com/fxhxyz4/gulp-racket
- Owner: fxhxyz4
- License: mit
- Created: 2024-01-28T15:53:10.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-02-19T12:13:29.000Z (3 months ago)
- Last Synced: 2026-02-19T16:39:10.488Z (3 months ago)
- Topics: gulp-plugin, racket-lang, racketscript
- Language: JavaScript
- Homepage: https://npmjs.com/package/gulp-racket
- Size: 375 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
## 
[gulp-racket](https://npmjs.com/package/gulp-racket) - [RacketScript](https://github.com/racketscript/racketscript) - [Gulp](https://gulpjs.com/)
### Dependencies:
- [Racket](https://racket-lang.org)
- [NodeJS](https://nodejs.org)
#
# Detailed Installation Guide for gulp-racket and RacketScript
## 1. Install gulp-racket via npm
```sh
npm install --save-dev gulp-racket
```
## 2. Download or clone RacketScript
Official repo: https://github.com/racketscript/racketscript
```sh
git clone https://github.com/racketscript/racketscript.git
cd racketscript
# (Optional: checkout to a specific branch or version)
```
## 3. Install RacketScript dependencies (requires Racket to be installed)
```sh
export PATH=$PATH:/var/lib/snapd/snap/bin
raco pkg install --auto racketscript
```
> **Note:**
> If you use snap/flatpak or another way to install Racket, make sure the `raco` command works and the package is installed for the correct Racket version.
## 4. Add the racks binary folder to your PATH
The `racks` executable is located in `racketscript/racketscript-compiler/bin`.
Add this folder to your PATH for your session (replace `/path/to/racketscript` with your actual path):
```sh
export PATH="$HOME/path-to-your-project/racketscript/racketscript-compiler/bin:$PATH"
```
> You can add this line to your `~/.bashrc`, `~/.zshrc`, or `~/.config/fish/config.fish` so it is always available.
## 5. Verify the installation
Run:
```sh
racks --help
```
You should see the RacketScript Compiler command help.
## 6. Use gulp-racket in your gulpfile.js
Example:
```js
const gulp = require('gulp');
const racket = require('gulp-racket');
gulp.task('default', () =>
gulp.src('src/index.rkt')
.pipe(racket())
.pipe(gulp.dest('dist'))
);
```
---
## Common problems
- **`racks` command not found:**
Make sure your PATH includes `racketscript/racketscript-compiler/bin`.
- **Complex numbers error:**
Complex numbers are not supported by JavaScript; rewrite your code to avoid them.
- **JS doesn't work in the browser:**
The generated JS uses ES6 modules and runtime files. Use `` and run through a local server.
---
## Links
- [RacketScript GitHub](https://github.com/racketscript/racketscript)
- [gulp-racket documentation](https://www.npmjs.com/package/gulp-racket)
#
### Usage:
```javascript
import racketTransform from 'gulp-racket';
const racket = () => {
return gulp
.src('./src/*.rkt')
.pipe(racketTransform(`./example/dist`))
.pipe(gulp.dest(`./example/dist`));
};
```
### Example usage: [view example folder](./example)
#
### Suggestions:
- [issues](https://github.com/fxhxyz4/gulp-racket/issues)
- [discussion](https://github.com/fxhxyz4/gulp-racket/discussions)
#
### License: [MIT License](https://fxhxyz.mit-license.org/)