# timsoft_platform_os

Backend-less Application Engine — Local-First, Sync-Ready

A lightweight Dart framework for building offline-first applications with clean architecture, repositories, and optional sync capabilities.

---

✨ Features

• Local-first architecture (works offline)
• Repository pattern for data access
• Event-driven system (EventBus)
• Live queries (reactive updates)
• Pluggable storage drivers (Memory / File)
• Sync engine support (optional)
• Authentication modules (JWT / OAuth / Magic Link)
• Multi-tenant ready design

---

🚀 Quick Start

import 'package:timsoft_os/timsoft_os.dart';

Future<void> main() async {
  final boot = await TimPlatform.boot(
    config: PlatformConfig.development,
  );

  boot.onFailure((e) => throw e);

  final tim = TimPlatform.instance;

  final todos = tim.collection<Map<String, Object?>>(
    'todos',
    toMap: (t) => t,
    fromMap: (m) => m,
  );

  await todos.create({'title': 'Hello TIMSoft OS'});

  final all = await todos.findMany();
  all.onSuccess((data) => print(data));
}

---

📦 Installation

dependencies:
  timsoft_os: ^0.1.0

---

🗄️ Storage Drivers

Driver	Use case
MemoryDriver	Testing / Development
FileDriver	Local persistence

---

🔄 Sync (Optional)

await TimPlatform.boot(
  cloud: NoOpCloudAdapter(),
);

tim.startSync();

---

📡 Realtime

tim.liveQuery('todos', fromMap: (m) => m)
   .watch()
   .listen((result) {
     print(result.items);
   });

---

🏗️ Architecture

• Repository-based design
• Event-driven communication
• Clean separation of layers
• No runtime reflection
• Fully modular system

---

📁 Project Structure

lib/
 ├── core/
 ├── database/
 ├── sync/
 ├── auth/
 ├── realtime/
 ├── api/
 ├── cloud/
 └── platform.dart

---

📄 License

MIT © 2026 TIMSoft DZ

---

💡 Note

This package is designed for developers who want:

• Local-first applications
• Clean architecture
• Extensible backend-less systems

---