# Flutter

> Paket sosialoka_ui memberi aplikasi Flutter tema Sosialoka untuk shadcn_ui dan Material.

Paket `sosialoka_ui` memberi aplikasi Flutter tema Sosialoka sesuai produknya, untuk widget `shadcn_ui` dan widget Material, di mode terang dan gelap.

## Pasang

Paket ini dipasang dari repositori design system:

```yaml
dependencies:
  shadcn_ui: ^0.59.0
  sosialoka_ui:
    git:
      url: https://gitlab.com/sosialoka/design-system.git
      path: flutter
```

## Pasang tema

Pilih produkmu dengan `SosialokaBrand`, atau `SosialokaBrand.neutral` untuk aplikasi yang bukan milik produk mana pun. `SosialokaTheme.shad` membuat tema `shadcn_ui`, dan `SosialokaTheme.material` membuat tema Material yang sepadan untuk layar yang masih memakai widget Material.

```dart
import 'package:flutter/material.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

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

  @override
  Widget build(BuildContext context) {
    const brand = SosialokaBrand.coverclearance;
    return ShadApp.custom(
      theme: SosialokaTheme.shad(brand, Brightness.light),
      darkTheme: SosialokaTheme.shad(brand, Brightness.dark),
      appBuilder: (context) => MaterialApp(
        theme: SosialokaTheme.material(brand, Brightness.light),
        darkTheme: SosialokaTheme.material(brand, Brightness.dark),
        builder: (context, child) => ShadAppBuilder(child: child!),
        home: const HomeScreen(),
      ),
    );
  }
}
```

Layar bisa dipindahkan satu per satu: layar Material dan layar `shadcn_ui` memakai warna dan radius yang sama.

## Warna tambahan

`shadcn_ui` tidak punya field untuk warna status, warna lembut, aksen tenant, atau warna brand. Baca dari tema dengan `context.sosialoka`:

```dart
ShadBadge(
  backgroundColor: context.sosialoka.successSoft,
  foregroundColor: context.sosialoka.success,
  child: const Text('Selesai'),
);
```

Nilai mentah, radius, spasi, dan ukuran teks juga tersedia sebagai konstanta: `SosialokaColors`, `SosialokaRadius`, `SosialokaSpace`, dan `SosialokaText`. Konstanta yang sama ada dalam satu file, [/tokens/sosialoka_tokens.dart](https://design.sosialoka.tech/tokens/sosialoka_tokens.dart), untuk aplikasi tanpa paket ini.

## Font

Tema memasang Plus Jakarta Sans lewat paket `google_fonts`, yang mengunduh font saat pertama dipakai. Aplikasi yang harus jalan offline sebaiknya menyertakan file font-nya dan mendaftarkannya di `pubspec.yaml`.

## Contoh

Setiap halaman komponen menampilkan kode Flutter-nya di tab Flutter. Kode yang sama jalan di aplikasi galeri di `flutter/example` dalam repositori, tempat `flutter analyze` dan tes render di setiap brand dan mode memeriksanya.
