Installation#

There are two supported starting points: scaffold a project with Oracular or add Arcane Jaspr to an existing Jaspr app.

Option 1: Scaffold with Oracular#

dart pub global activate oracular
oracular create app --template arcane_jaspr_app --name my_app
oracular create app --template arcane_jaspr_docs --name my_docs

The repo-owned templates already target the Flutter-first Arcane Jaspr surface.

Option 2: Add Arcane Jaspr to an Existing Jaspr App#

Prerequisites#

• Dart SDK >=3.10.0
• Jaspr CLI

dart pub global activate jaspr_cli

Add the Package#

dependencies:
  arcane_jaspr: ^3.0.0

dart pub get

Use the Primary Import#

import 'package:arcane_jaspr/arcane_jaspr.dart';

Only add these if you intentionally need them:

import 'package:arcane_jaspr/html.dart';
import 'package:arcane_jaspr/web.dart';

Wrap the App Root#

import 'package:arcane_jaspr/arcane_jaspr.dart';

class App extends StatelessWidget {
  const App({super.key});

  @override
  Widget build(BuildContext context) {
    return ArcaneApp(
      stylesheet: const ShadcnStylesheet(theme: ShadcnTheme.midnight),
      brightness: Brightness.dark,
      child: const Text('Ready'),
    );
  }
}

Run the App#

jaspr serve

Build Static Output#

jaspr build