Installation

flutter_skin is a native Dart package that fetches and applies your published skin from the FSkin dashboard at runtime. It works on all Flutter platforms — Android, iOS, Web, macOS, Windows, and Linux.

Requirements

Flutter >=3.0.0
Dart >=3.0.0
An FSkin account with at least one project and an active skin.

Add the Package

Add flutter_skin to your pubspec.yaml:

dependencies:
  flutter:
    sdk: flutter
  flutter_skin: ^0.0.1

Then run:

flutter pub get

Get Your API Key

Log in to app.fskin.dev
Open your project → API Keys tab
Copy the key — it starts with fsk_

Store your API key securely. Avoid committing it directly to version control. Use environment variables or a secrets file excluded from git.

Initialize the Package

Call FlutterSkin.init() before runApp in your main() function:

import 'package:flutter/material.dart';
import 'package:flutter_skin/flutter_skin.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await FlutterSkin.init(
    apiKey: 'fsk_your_api_key_here',
  );

  runApp(const MyApp());
}

Apply the Skin

Pass FlutterSkin.toThemeData() to your MaterialApp:

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'My App',
      theme: FlutterSkin.toThemeData(),
      home: const HomePage(),
    );
  }
}

That’s it (Literally 2 lines of code, 2 seconds wasted 😎). Your app now fetches and applies the active skin from the FSkin dashboard on every launch.

If the network is unavailable on launch, flutter_skin uses the last cached skin automatically. For the very first launch before any skin has been fetched, you can provide a fallback — see Implementation.

Supported Platforms

Platform	Supported
Android	✓
iOS	✓
Web	✓
macOS	✓
Windows	✓
Linux	✓
Fuchsia	✓
All Platforms	✓

Getting Started

Dashboard

Package

Installation

Requirements

Add the Package

Get Your API Key

Initialize the Package

Apply the Skin

Supported Platforms

​Requirements

​Add the Package

​Get Your API Key

​Initialize the Package

​Apply the Skin

​Supported Platforms

Requirements

Add the Package

Get Your API Key

Initialize the Package

Apply the Skin

Supported Platforms