# Jarajara ジャラジャラ — Mahjong tiles and mahjong solitaire > Jarajara ジャラジャラ — Mahjong tiles and mahjong solitaire: the 144-tile set in 42 SVG faces, stacked layouts, matching rules, seeded deals and Awase alone or at a table of two to four. TypeScript, zero dependencies. Install with `npm install @johnmorrisdotca/jarajara`. Every page below is also an HTML page at the same address ending in .html; the documentation's home is https://johnmorrisdotca.github.io/jarajara/docs/. The examples on the reference pages are run when the site is built, and what they print is shown under them. ## Guides - [Getting started](https://johnmorrisdotca.github.io/jarajara/docs/guides/getting-started.md): Install Jarajara and deal a seeded Awase layout. - [Read names, notation and racks](https://johnmorrisdotca.github.io/jarajara/docs/guides/names-and-racks.md): Tell tile codes from notation, arrange a rack without changing its tiles, and use the rack element. - [Draw SVG and select designs](https://johnmorrisdotca.github.io/jarajara/docs/guides/draw-and-designs.md): Draw tiles and layouts as SVG strings or elements, load only the designs you need, and keep SVG identifiers apart. - [Play solitaire and challenges](https://johnmorrisdotca.github.io/jarajara/docs/guides/play-awase.md): Take free matching pairs, pass the time in yourself for challenges, and keep hints and refusals. - [Play at a shared table](https://johnmorrisdotca.github.io/jarajara/docs/guides/shared-table.md): Play two to four players at one table, score pairs, and restore a table from its record. - [Embed racks, elements and sounds](https://johnmorrisdotca.github.io/jarajara/docs/guides/embed-and-sounds.md): Register the tile elements in a browser, embed a rack, and add optional sounds. - [Stacked geometry and SVG views](https://johnmorrisdotca.github.io/jarajara/docs/guides/stacked-layouts.md): Place tiles on a half-tile grid, draw the same layout in different views, and keep rules apart from display. - [Seeded deals and replayed records](https://johnmorrisdotca.github.io/jarajara/docs/guides/records-and-seeds.md): Generate a solvable layout from a seed, save it as a layout and moves, and replay it. - [Troubleshooting and FAQ](https://johnmorrisdotca.github.io/jarajara/docs/guides/troubleshooting.md): Find out why a pair cannot be taken, what null means, and why an element or sound does not work. - [Upgrading and moving from other libraries](https://johnmorrisdotca.github.io/jarajara/docs/guides/upgrading.md): Keep the 1.x baseline and choose the right feature when coming from another mahjong library. ## Reference - [@johnmorrisdotca/jarajara/awase](https://johnmorrisdotca.github.io/jarajara/docs/api/awase/index.md): Awase (合わせ, "matching"): the matching solitaire. - [@johnmorrisdotca/jarajara/table](https://johnmorrisdotca.github.io/jarajara/docs/api/table/index.md): Awase at a table, for two to four: one layout, turns taken, each pair scoring (the plain suits one, ones and nines two, a wind three, a dragon four, a flower or season two and another turn), most points wins. - [@johnmorrisdotca/jarajara/faces](https://johnmorrisdotca.github.io/jarajara/docs/api/faces/index.md): The tiles, drawn: each of the 42 faces as SVG text, a tile on its own, its back, and a whole layout of stacked tiles, on a cloth if you like. - [@johnmorrisdotca/jarajara/element](https://johnmorrisdotca.github.io/jarajara/docs/api/element/index.md): Jarajara's custom elements, as classes, with nothing defined: import this to extend them or to define them under other names. - [@johnmorrisdotca/jarajara/element/define](https://johnmorrisdotca.github.io/jarajara/docs/api/element-define/index.md): Defines Jarajara's custom elements on the page: ``, ``, ``, ``, ``, `` and ``. - [@johnmorrisdotca/jarajara/designs/riichi](https://johnmorrisdotca.github.io/jarajara/docs/api/designs-riichi/index.md): The regular riichi design: FluffyStuff's riichi mahjong tiles (public domain, CC0; see CREDITS.md), the 34 faces of a riichi set with the tile's own plate and back and the red fives. - [@johnmorrisdotca/jarajara/designs/riichi-black](https://johnmorrisdotca.github.io/jarajara/docs/api/designs-riichi-black/index.md): The black riichi design: FluffyStuff's riichi mahjong tiles (public domain, CC0; see CREDITS.md), the 34 faces of a riichi set with the tile's own plate and back and the red fives. - [@johnmorrisdotca/jarajara/tile-sounds](https://johnmorrisdotca.github.io/jarajara/docs/api/tile-sounds/index.md): The sounds of a mahjong table: a tile picked up, set down or turned over, a pair knocked together, the tiles shuffled, a clatter for a win. - [@johnmorrisdotca/jarajara/sounds](https://johnmorrisdotca.github.io/jarajara/docs/api/sounds/index.md): Recorded sounds - [@johnmorrisdotca/jarajara](https://johnmorrisdotca.github.io/jarajara/docs/api/main/index.md): Jarajara: mahjong tiles for JavaScript and TypeScript. ## Optional - [Changelog](https://johnmorrisdotca.github.io/jarajara/docs/changelog.md): every release - [Every export, in full](https://johnmorrisdotca.github.io/jarajara/llms-full.txt) - [Source](https://github.com/johnmorrisdotca/jarajara)