Skip to content

mohamedshemees/kmp-resources-unfold

Repository files navigation

Kmp Resources Unfold Logo

Kmp Resources Unfold

Downloads License: MIT

Kmp Resources Unfold is a professional productivity tool designed for Android Studio and IntelliJ IDEA developers. It bridges a major gap in the IDE by providing visual management and robust import capabilities for assets across all your Kotlin Multiplatform (KMP) modules.

  • Figma Bridge Integration: Seamlessly import assets directly from Figma via a local HTTP server into the Import Dialog. Get the Figma Plugin: KMP Resources Unfold
  • Professional Asset Importing: A complete workflow for importing SVGs and raster images, with automatic density grouping, SVG-to-XML conversion, and prefixing.
  • Native XML Rendering: Render Android Vector Drawables (.xml) directly in the list.
  • Unified Asset Explorer: Browse XML vectors, SVGs, and raster images from all modules.
  • Seamless Integration: Designed to feel like a native part of the IDE UI.

📺 Demo

plugin_demo_upload.mp4

🛠 Features

  • Figma Bridge Integration: Seamlessly import assets directly from Figma via a local HTTP server.
  • Advanced Asset Importing:
    • SVG to XML: Automatically converts SVGs to Android Vector Drawables on import.
    • Multi-Density Support: Auto-detects and groups images by density (e.g., image@2x.png -> drawable-xhdpi/image.png).
    • Smart Prefixing: Optionally applies standard ic_ (vector) or img_ (image) prefixes.
    • Live Previews: Preview assets and their exact target paths before importing.
    • "Import & Choose More" Action: Batch-import currently selected assets and immediately reset selection queues/file choosers to continue importing assets in a single run.
  • Instant Previews: High-fidelity rendering of vectors with support for gradients and transparency.
  • Design & Font Preview Tabs:
    • Vector Assets: A specialized tab with smooth zoom, actual size reset, and auto-refresh on save.
    • Font Assets: A dedicated interactive preview tab for .ttf files featuring:
      • Flexible Sizing: Smoothly adjust font size from 8pt to 120pt.
      • Synthetic Styling: Instant Bold/Italic formatting switches.
      • Specimen Area: Type custom text and see it instantly rendered.
      • Waterfall View: Inspect how the font scales at standard typographic sizes.
      • Character Map: View the complete printable Basic Latin character grid and Unicode code points.
      • Details Pane: Displays the font's metadata (Name, Family, Format, File Size).
  • Smart Interaction & Editor Previews:
    • Single Click: Copy the resource path to clipboard with an instant notification.
    • Double Click: Open the source file directly in the editor.
    • Instant Hovers: Hover over Res.drawable.xxx, Res.string.xxx, or Res.font.xxx to see an image preview, localized translations, or font specimen styled in the actual typeface.
    • Gutter Previews: Gutter icons displaying styled "Aa" previews using the typeface and weight of the matching font asset. Click the gutter icon to swap resource references on the fly.
  • Live Filtering: Filter assets by category (Vectors/Images/Fonts/Strings) with real-time counts.
  • Smart Localization Support (Strings):
    • Missing Translation Warnings: Instantly spot strings that are missing translations across your values directories.
    • Quick Navigation: Use Ctrl + Click (or Cmd + Click) on a string key to instantly navigate between its translations.

🚀 Installation

Using JetBrains Marketplace (Recommended)

  1. Open Settings/Preferences > Plugins > Marketplace
  2. Search for Kmp Resources Unfold
  3. Click Install and restart your IDE.

Alternatively, go to the JetBrains Marketplace and install it by clicking the Install to ... button if your IDE is running.

Manual Installation

  1. Download the latest .zip or .jar from the Releases Page.
  2. Open Android Studio or IntelliJ IDEA.
  3. Go to Settings/Preferences > Plugins > ⚙️ > Install plugin from disk...
  4. Select the downloaded file and restart the IDE.

💻 Tech Stack & Requirements

Android Studio IntelliJ IDEA Kotlin

  • Supported IDEs: Android Studio Ladybug (2024.2+) & IntelliJ IDEA (2024.2+).
  • Target Projects: Kotlin Multiplatform (KMP), Compose Multiplatform.

🐛 Reporting Issues

If you encounter any bugs or have feature requests, please Open an Issue. To help us resolve it quickly, please include:

  • 💻 Operating System (Windows, macOS, or Linux).
  • 📱 IDE & Version (e.g., Android Studio Ladybug 2024.2.1).
  • 📸 Screenshots or Screen Recording of the issue.
  • 📝 Steps to reproduce the problem.

⚖️ Legal & Credits


Developed with ❤️ for the Android & KMP Community

About

A productivity plugin for Android Studio & IntelliJ. Visually manage KMP resources (Vectors, SVGs, Images), preview assets, and easily navigate string translations across all modules

Resources

License

Contributing

Stars

20 stars

Watchers

0 watching

Forks

Contributors

Languages