Make developing Magic: The Gathering (MTG) apps a breeze!

Examples

Develop custom MTG Flutter widgets easily with full support for MTG mana and other symbols:

Full support for "Un" sets as well:

Features

• Model representing an MTG card
• Double-faced card support
• Convert JSON to model instances using supported fromMap constructor
• SVGs for all MTG symbols and helpful methods to display them
• Minimal external dependencies - only flutter_svg and collection are used
• Works on Android, iOS, Linux, MacOS, Web, Windows

Getting started

You will need to provide data for the MTG cards yourself. Consider downloading or requesting some using the Scryfall API (which this package is fully interoperable with)!

Then instantiate an MTGCard using the model's fromMap constructor.

final blackLotus = MTGCard.fromMap({
    "keywords": [],
    "lang": "en",
    "rarity": "bonus",
    "released_at": "2014-06-16",
    "reserved": true,
    "set": "vma",
    "set_name": "Vintage Masters",
    "artist": "Chris Rahn",
    "image_uris": {
    "art_crop":
        "https://cards.scryfall.io/art_crop/front/b/d/bd8fa327-dd41-4737-8f19-2cf5eb1f7cdd.jpg?1614638838",
    },
    "mana_cost": "{0}",
    "cmc": 0.0,
    "name": "Black Lotus",
    "oracle_text":
        "{T}, Sacrifice Black Lotus: Add three mana of any one color.",
    "type_line": "Artifact",
});

A default constructor is not currently supported for the MTGCard model. The recommended use case is to store or request the MTG card data as JSON and parse it into Dart Map objects.

API

MTGCard

Properties

Property	Description	Return Type
hasMultipleFaces	Whether the card object has more than one face	bool
sizeRatio	The ratio of an MTG card's height to its width	double
cornerRatio	The ratio of an MTG card's height to its corner radius	int

MTGCardFace

MTGCard extends MTGCardFace, so all its methods are accessible from MTGCard instances as well.

Methods

Method	Description	Return Type
preparedManaCost	Displays the card's mana cost using MTG symbol SVGs	List<Widget>?
preparedOracleText	Displays the card's oracle text using MTG symbol SVGs	TextSpan?

MTGSymbol

Methods

Method	Description	Return Type
toSvg	Converts the MTGSymbol object into an SVG widget	SVGPicture

Properties

Property	Description	Return Type
regex	Matches text that can be converted to an MTGSymbol	RegExp

mtgSymbology

A Map of String keys and MTGSymbol instance values. The keys are based on the notation used in Magic: The Gathering's Comprehensive Rules.

The MTGCardFace.preparedManaCost method and the MTGCardFace.preparedOracleText method use this under the hood.

Example

Below shows an example of how to display a simple widget. The example assumed you already have an MTGCard instance named blackLotus.

final cardImage = blackLotus.images?['art_crop'];
final child = Column(
    crossAxisAlignment: CrossAxisAlignment.start,
    children: [
    Row(
        children: [
        Text(blackLotus.name),
        const Spacer(),
        ...?blackLotus.preparedManaCost(),
        ],
    ),
    const SizedBox(height: 8.0),
    if (cardImage != null) Image.network(cardImage),
    const SizedBox(height: 8.0),
    Text(blackLotus.typeLine),
    Text.rich(blackLotus.preparedOracleText() ??
        TextSpan(text: blackLotus.oracleText)),
    ],
);
return Scaffold(
    appBar: AppBar(
    backgroundColor: Theme.of(context).colorScheme.inversePrimary,
    title: Text('Magic: the Gathering Flutter App'),
    ),
    body: SafeArea(
    child: Center(child: child),
    ),
);

For a more detailed example, look in the example directory.

Contributing

Contributions are welcome! Be sure to follow the linter rules defined in the analysis_options file.

Legal

As part of the Wizards of the Coast Fan Content Policy, this package is provided free of charge to view, access, share, and use without paying for anything, obtaining any approval, or giving anyone credit.

magic_the_gathering_flutter is unofficial Fan Content permitted under the Fan Content Policy. Not approved/endorsed by Wizards. Portions of the materials used are property of Wizards of the Coast. ©Wizards of the Coast LLC.