SuperDeck

SuperDeck is a Flutter presentation framework. You write slides in Markdown, and SuperDeck renders them with Flutter.

• Live demo: https://superdeck-dev.web.app
• Example deck: demo/slides.md
• Documentation (in this repo): docs/

Quickstart

1. Install the CLI:

   dart pub global activate superdeck_cli

2. Create a Flutter app and configure SuperDeck:

   flutter create your_presentation
   cd your_presentation
   superdeck setup
   flutter pub get

3. Initialize SuperDeck in lib/main.dart:

   import 'package:flutter/widgets.dart';
   import 'package:superdeck/superdeck.dart';
   
   Future<void> main() async {
     WidgetsFlutterBinding.ensureInitialized();
     await SuperDeckApp.initialize();
   
     runApp(const SuperDeckApp(options: DeckOptions()));
   }

4. Add slides.md, then build slides and run the app:

   dart run superdeck_cli:main build --watch
   flutter run

Write slides

Use paired frontmatter fences to separate slides.

---
title: Welcome
---

@block
# Welcome

@block
- Write slides in Markdown
- Use blocks for layout

---
---

Learn more

• docs/getting-started.mdx
• docs/guides/cli-reference.mdx
• docs/reference/block-types.mdx
• docs/reference/deck-options.mdx

Contributing

SuperDeck is a Melos workspace pinned via FVM in .fvmrc.

fvm use --force
fvm dart run melos bootstrap
fvm dart run melos run analyze
fvm dart run melos run test