Question 1

How to install Spago for PureScript?

Accepted Answer

Install Spago globally via npm with 'npm install -g spago', but note you must also have the PureScript compiler installed separately, typically with 'npm install -g purescript'. This two-step setup is common in the ecosystem.

Question 2

Spago vs psc-package for PureScript?

Accepted Answer

Spago is the modern successor to psc-package, offering curated package sets for reproducibility and additional features like monorepo support and bundling. While psc-package is simpler, Spago provides a more integrated workflow for larger projects.

Question 3

How to bundle PureScript code with Spago?

Accepted Answer

Use 'spago bundle' with flags like --bundle-type and --platform; it wraps esbuild to create single JS files for Node.js or browsers. Configuration can be set in spago.yaml for options like minification or source maps.

Question 4

Does Spago support watch mode?

Accepted Answer

No, the new PureScript rewrite of Spago does not include built-in watch mode, unlike the legacy Haskell version. Developers need to rely on external tools or scripts for automatic recompilation during development.

Question 5

How to add a local package to Spago?

Accepted Answer

Override a package in the workspace by adding it to the extraPackages section in spago.yaml with a path field, e.g., 'extraPackages: { my-pkg: { path: ../local-pkg } }', then run 'spago install' to include it in the build.

Question 6

Spago monorepo setup tutorial?

Accepted Answer

Create a top-level spago.yaml with a workspace section, then define packages in subdirectories with their own spago.yaml files. Use the --package flag to target specific packages for commands like build or test.

Question 7

How to test PureScript code with Spago?

Accepted Answer

Use 'spago test' after configuring test dependencies in the package.test section of spago.yaml; it supports runners like spec-node and allows passing arguments with -- to customize test execution.

spago

What is spago?

Overview

Use Cases

Best For

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions