Poké-Fun with Kotlin and Arrow

Welcome! In this guide we (well, actually you) are going to work on an application to build decks for the Pokémon Trading Card Game (TCG). Each chapter roughly corresponds to a different functionality: loading decks, searching cards, and so on.

The source code is available in this repository. Download or clone it, and you should be ready to go. We recommend that you load fonts/pokemon-rs.ttf in your system for the extra 2000's vibes.

This book assumes that you know your way around Kotlin, but previous experience with functional programming or Arrow, or with Compose Multiplatform, is not required.

The starting point introduces the domain and the main components of the technology.

• If you have never heard of the Pokémon Trading Card Game or don't know the rules, start with the introduction to the domain;
• If you are new to Amper or Compose Multiplatform, start with the technology,

Afterward, the overview describes the main components of the given code. The rest of the guide is divided into a series of more or less independent sections, so you can choose what you want to work on. Each section contains an introduction to one or more topics, and pointers to additional tutorials or documentation about them.

• What is (in) a deck: model data using data classes and sealed hierarchies;
• Law-abiding decks: check that the deck follows the rules, and learn about Raise along the way;
• Deck building: design a good ViewModel using functional principles, and design undo/redo with actions-as-data;
• Deal with bad internet: improve the experience with Schedule and CircuitBreaker, and cache results using memoization;
• Loading and saving: store your work locally, and learn about parallel combinators in Arrow Fx;
• Better architecture: introduce resource management, and overall nicer design;
• Nicer UI: implement more visual feedback using Compose Multiplatform.