Quick Links: Installation | Quick Start | Documentation | Examples | Troubleshooting

Managing UI in Unity games often becomes a tangled mess of direct references, scattered open/close logic, and manual lifecycle management. This UI Service solves these pain points:

Built for production: Used in real games with WebGL, mobile, and desktop support. Zero per-frame allocations in hot paths.

• 🎭 UI Model-View-Presenter Pattern - Clean separation of UI logic with lifecycle management
• 🎨 UI Toolkit Support - Compatible with both uGUI and UI Toolkit
• 🧩 Feature Composition - Modular feature system for extending presenter behavior
• 🔄 Async Loading - Load UI assets asynchronously with UniTask support
• 📦 UI Group Organization - Organize UI elements by depth layers and in groups for batch operations
• 💾 Memory Management - Efficient loading/unloading of UI assets with Unity's Addressables system
• 🛠️ Editor Tools - Presenter Manager window for real-time debugging and monitoring
• 📱 Responsive Design - Built-in support for device safe areas (e.g. iPhone dynamic island)

• Unity (v6.0+) - To run the package
• Unity Addressables (v2.6.0+) - For async asset loading
• UniTask (v2.5.10+) - For efficient async operations
• Universal Render Pipeline (v17.0.1+) - Required by the camera-stacking and backdrop-blur presenter features (Runtime/Rendering/)

Dependencies are automatically resolved when installing via Unity Package Manager.

Using the backdrop blur needs one manual step: add UiBackdropBlurRendererFeature to your Universal Renderer asset (Add Renderer Feature), not just the presenter component. Without it the blur silently does nothing. See URP Rendering Features.

1. Open Unity Package Manager (Window → Package Manager)
2. Click the + button and select Add package from git URL
3. Enter the following URL:

   https://github.com/CoderGamester/com.gamelovers.uiservice.git
   

Add the following line to your project's Packages/manifest.json:

{
  "dependencies": {
    "com.gamelovers.uiservice": "https://github.com/CoderGamester/com.gamelovers.uiservice.git"
  }
}

openupm add com.gamelovers.uiservice

1. Right-click in Project View
2. Navigate to Create → ScriptableObjects → Configs → UiConfigs
3. Configure your UI presenters in the created asset

using UnityEngine;
using GameLovers.UiService;

public class GameInitializer : MonoBehaviour
{
    [SerializeField] private UiConfigs _uiConfigs;
    private IUiServiceInit _uiService;
    
    void Start()
    {
        _uiService = new UiService();
        _uiService.Init(_uiConfigs);
    }
}

using UnityEngine;
using GameLovers.UiService;

public class MainMenuPresenter : UiPresenter
{
    [SerializeField] private Button _playButton;
    
    protected override void OnInitialized()
    {
        _playButton.onClick.AddListener(OnPlayClicked);
    }
    
    protected override void OnOpened()
    {
        Debug.Log("Main menu opened!");
    }
    
    protected override void OnClosed()
    {
        Debug.Log("Main menu closed!");
    }
    
    private void OnPlayClicked()
    {
        Close(destroy: false);
    }
}

// Open UI
var mainMenu = await _uiService.OpenUiAsync<MainMenuPresenter>();

// Check visibility
if (_uiService.IsVisible<MainMenuPresenter>())
{
    Debug.Log("Main menu is visible");
}

// Close UI
_uiService.CloseUi<MainMenuPresenter>();

📖 For complete setup guide, see Getting Started

The package includes sample implementations in the Samples~ folder.

1. Open Unity Package Manager (Window → Package Manager)
2. Select "GameLovers UiService" package
3. Navigate to the "Samples" tab
4. Click "Import" next to the sample you want

Contributions are welcome! Report bugs or request features via GitHub Issues. For development setup, architecture, assembly conventions, and coding standards, see AGENTS.md.

• Issues: Report bugs or request features
• Discussions: Ask questions and share ideas
• Changelog: See CHANGELOG.md for version history

This project is licensed under the MIT License - see the LICENSE.md file for details.

Made with ❤️ for the Unity community

If this package helps your project, please consider giving it a ⭐ on GitHub!