Introduction
What Vizco is and how it works — upload images, organize them into folders, configure widgets, and deliver them anywhere.
Vizco is a platform for building, customizing, and delivering image widgets to any application. Upload your images once, organize them into folders, configure beautiful layouts, and ship pixel-perfect experiences via CDN or native SDKs.
Core workflow
The Vizco workflow follows four steps:
Upload
Upload images to your project. Vizco stores them securely and makes them available for delivery via CDN with on-the-fly resizing and format conversion.
Organize
Organize your assets into folders for easier management. Folders are optional — you can also add assets directly to widgets.
Configure
Create a widget and select the assets you want to display. Choose a layout (carousel, grid, masonry, slider, or list), configure its behavior, and apply a theme. Drag and drop to reorder assets. Publish when you're ready.
Deliver
Fetch the published widget in your app using a native SDK or the REST API. Vizco provides SDKs for Android (Jetpack Compose), iOS (SwiftUI), and React — each renders widgets with a single component. The API returns JSON you can render however you like.
Key concepts
- Organizations — Multi-tenant accounts that own projects and users.
- Projects — Containers for assets, folders, widgets, and API keys.
- Assets — Uploaded images with metadata, tags, and alt text.
- Folders — Optional organizational groups for managing assets.
- Widgets — Configured layouts referencing an ordered list of assets, with a theme that can be published and delivered.
- API Keys — Project-scoped keys (
pk_prefix) used to fetch published widgets.
What's next?
- Follow the Quickstart to create your first widget in minutes.
- Read about Authentication to understand JWT vs API key auth.
- Integrate widgets in your app:
- Android SDK — Jetpack Compose
- iOS SDK — SwiftUI
- React SDK — React / Next.js