dmmulroy / create-melange-app

The fastest, friendliest, and most delightful way to get started with OCaml, ReasonML, and Melange, geared towards JavaScript and TypeScript developers
118 stars 20 forks source link
functional-programming javascript ocaml reasonml typescript

create-melange-app

✨create-melange-app✨

The fastest, friendliest, and most delightful way to get started with OCaml, ReasonML, and Melange, geared towards JavaScript and TypeScript developers

Get started by running npm create melange-app@latest

[![PRs-Welcome][contribute-image]][contribute-url] [![Discord](https://img.shields.io/discord/1155360855748251788?color=%235865F2&label=Discord&logo=discord&logoColor=%23fff)](https://discord.gg/fNvVdsUWHE) [![NPM version][npm-image]][npm-url] [![Downloads][downloads-image]][npm-url]
## Table of contents - What Is create-melange-app? - Getting Started - Community, Help, & Resources - Contributors 🫶 - Special Thanks

What Is create-melange-app?

create-melange-app is an opinionated CLI tool for quickly getting started with Melange, a compiler for compiling OCaml and ReasonML to JavaScript. It is geared at feeling familiar for developers coming from a JavaScript or TypeScript background and focused on enabling them to be productive as quickly as possible.

If you want to learn more about OCaml, ReasonML, and Melange, check out Dillon Mulroy's conference talk on Melange and how it can be a more type safe solution for your apps than TypeScript.

'Melange: The next frontier in type-safe web development' by Dillon Mulroy - RVAJS 2023

Watch on Youtube here

Getting Started

To scaffold an app using `create-melange-app`, run any of the following commands and answer the command prompt questions: ### npm ```bash npm create melange-app@latest ``` ### pnpm ```bash pnpm create melange-app@latest ``` ### bun ```bash bun create melange-app@latest ```

Community, Help, & Resources

- [The Caravan Discord Server](https://discord.gg/fNvVdsUWHE) - This is where the maintainers of `create-melange-app` hang out! - [OCaml's official site](https://ocam.org) - [ReasonML's official site](https://reasonml.github.io/) - [Melange Docs](https://melange.re) - [OCaml Discuss Forums](https://discuss.ocaml.org/) - [OCaml Discord Server](https://discord.gg/Qpzjmc4t) - [ReasonML Discord Server](https://discord.gg/jPEH58TU)

Contributors

We 🫶 contributors! Feel free to contribute to this project. We want `create-melange-app` to be a project where developers new to OCaml & ReasonML can learn and contribute meaningfully. A contributing guide and roadmap will be coming soon! In the mean time, please check in at [The Caravan Discord](https://discord.gg/fNvVdsUWHE) for help getting started working on `create-melange-app`.

Made with contrib.rocks

Special Thanks

I (Dillon) wanted to give special thanks to a few folks and groups.

1. Everyone who has supported me while coding `create-melange-app` on [twitch](https://twitch.tv/dmmulroy). 2. The Melange core team for always being superbly helpful and building an amazing tool. 3. All the contributors to [create-t3-app](https://github.com/t3-oss/create-t3-app/tree/main). Your work and code has been a huge inspiration to me. [downloads-image]: https://img.shields.io/npm/dm/create-melange-app?color=209fb5&logoColor=364fc7 [npm-url]: https://www.npmjs.com/package/create-melange-app [npm-image]: https://img.shields.io/npm/v/create-melange-app?color=e64553&logoColor=0b7285 [contribute-url]: https://github.com/dmmulroy/create-melange-app/blob/main/CONTRIBUTING.md [contribute-image]: https://img.shields.io/badge/PRs-welcome-blue.svg