> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fskin.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> FSkin — remote skin management for Flutter. Change your app's colors live, without shipping an update.

FSkin is a remote skin engine for Flutter. Define your app's color scheme as named tokens, manage them from the [FSkin dashboard](https://app.fskin.dev), and publish changes that reach every connected device instantly — no App Store update, no restart.

<Tip>
  New to FSkin? Start with the [Quickstart Guide](/quickstart) and have your app connected in under 5 minutes.
</Tip>

## How It Works

```
Publish skin on dashboard
        ↓
FSkin backend broadcasts the change
        ↓
flutter_skin package receives the event via SSE
        ↓
App re-renders with new colors — while open, in real time
```

Every Flutter app running `flutter_skin` maintains a lightweight persistent connection to the FSkin backend. When you publish a skin, the change is pushed to all connected instances immediately — no polling, no manual refresh.

<Card title="Quickstart" icon="rocket" href="/quickstart">
  Get your Flutter app connected to FSkin in 2 lines of code.
</Card>

## Core Concepts

**Skin** — a named set of color tokens that maps directly to Flutter's `ColorScheme`. One skin is active per project at a time.

**Project** — represents a single Flutter project (Android, iOS, Web or desktop). Holds multiple skins and API keys and belongs to a team.

**Team** — groups developers together. Team members can manage projects and skins based on their roles and permissions.

**API Key** — scoped to a project. Used by the `flutter_skin` package to authenticate and fetch skins. Auto-generated when a project is created, you can create additional keys for different environments (e.g., staging, production).

**Live push** — when a skin is published, all connected Flutter app instances receive the update via Server-Sent Events (SSE) and re-render immediately without a restart.

## Documentation Tree

<AccordionGroup>
  <Accordion title="Dashboard" icon="rectangle-history">
    * [Overview](/dashboard/overview) - Dashboard features and navigation
    * [Projects](/dashboard/projects) - Manage and organize your projects
    * [Skins](/dashboard/skins) - Create, publish, and manage skins
    * [Teams](/dashboard/teams) - Team management and collaboration
  </Accordion>

  <Accordion title="Package" icon="cube">
    * [Installation](/package/installation) - Add flutter\_skin to your project
    * [Implementation](/package/implementation) - Usage examples and live update setup
    * [Contribution](/package/contribute) - Contributing to the open source package
  </Accordion>
</AccordionGroup>