purescript/documentation

Welcome to the PureScript documentation repository!

PureScript is a small, strongly typed programming language that compiles to JavaScript. To get a better overview of PureScript, visit The PureScript Website.

This repository is a collaborative effort, so please feel free to make a pull request to add/edit content or create an issue to discuss it. PureScript is a big project used by people coming from a variety of backgrounds. Making documentation useful to a wide variety of people is really hard to do well, requiring readers like you to point out and add documentation you feel is missing. Thanks for helping!

Directory

Getting Started

• Getting Started: Download PureScript and build your first project
• Try PureScript: Try PureScript in your browser

Community

• Discourse: Discuss PureScript in a forum setting
• Discord: Chat about PureScript and attend video / audio meetups

Learning

• The PureScript Book is the recommended approach to learning the language, since it covers more material in greater depth.
• The Functional Programming Made Easier will start you at the very beginning with the basics. The book assumes that you know nothing about Functional Programming, and teaches you functional concept with Purescript and in the final few chapters it will build a Full-Stack web server and browser-based front end written in PureScript.
• Language Reference
• PureScript: Jordan's Reference: An up-to-date project covering Getting Started, Build Tools, PureScript's syntax with examples, FP design patterns, and PureScript's ecosystem.
• PureScript Cookbook: An unofficial cookbook for PureScript.
• A guide to the PureScript numeric hierarchy: An introduction to the mathematics behind the numeric hierarchy of type classes in PureScript’s Prelude. (See also PureScript numeric hierarchy overview.)
• PureScript Resources: A collection of notes and links to resources to learn and use PureScript.

Guides

• Common Operators
• The Foreign Function Interface (FFI)
• FFI Tips
• Custom Type Errors
• PureScript Without Node
• Contrib Library Guidelines
• Error Suggestions
• psc-ide FAQ
• Try PureScript Help

Tools

• Editor and tool support: Editor plugins, build tools, and other development tools
• easy-purescript-nix: Set up PureScript and development environment with Nix
• PSCi: An interactive development tool for PureScript

Ecosystem

• Maintained Packages
• Style Guide
• Alternate Backends: PureScript can compile to other languages as well!
• Recommended tooling for PureScript in 2020

Articles

• 24 Days of PureScript 2016

Talks/Meetups

• PureScript Presentations
• PureScript Meetups

Related Languages

• Related Projects
• Differences from Haskell

Project Scope

Topics currently in this repository's scope:

• PureScript language reference documentation
• Its compiler errors
• Core concepts on which the language is based
• Comparison with similar languages
• An introduction to other sources of documentation

Topics currently not in scope:

• Using PureScript libraries (those docs belong with the corresponding libraries)
• A PureScript language teaching course (use the PureScript by Example book or other resources)
• Introduction to package managers and dependency management

Feel free to make an issue to discuss amending the scope.

License

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.