Question 1

How do I bundle PureScript code with npm dependencies using Pulp?

Accepted Answer

Use `pulp browserify` which integrates Browserify to bundle PureScript with CommonJS dependencies. For example, after installing a package like React via npm, run `pulp browserify --to bundle.js` to include it in your output, as explained in the CommonJS Aware Builds section.

Question 2

What's the difference between Pulp and Spago for PureScript projects?

Accepted Answer

Pulp is primarily a build tool focusing on conventions and CLI tasks for compiling, testing, and bundling, while Spago is a package manager and build tool with a different dependency resolution approach. The README notes that for publishing, you might use spago to prepare before using pulp's publish commands.

Question 3

Can I use Pulp for server-side PureScript projects?

Accepted Answer

Yes, Pulp supports Node.js projects with `pulp run`, which compiles and executes your code. You can pass command-line arguments to your application using `pulp run -- arg1 arg2`, as demonstrated in the Running Your PureScript Project section.

Question 4

How do I generate HTML documentation with Pulp?

Accepted Answer

Run `pulp docs -- --format html` to extract inline documentation and produce HTML files in the generated-docs folder. This allows you to preview Pursuit-style docs before publishing, as mentioned in the Building Documentation section.

Question 5

Does Pulp support watch mode for tests?

Accepted Answer

Yes, use `pulp --watch test` to continuously run your test suite whenever source files change, providing immediate feedback during development. This is highlighted in the Running Test Suites part of the README.

Question 6

How can I add custom pre-build or post-build commands in Pulp?

Accepted Answer

Pulp offers `--before`, `--then`, and `--else` options to run commands before or after actions. For instance, `pulp --watch --before clear build` clears the screen before each build, as shown in the Running Commands Before and After an Action section.

pulp

What is pulp?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions