ADVANCED
Templates
Use and create collection templates from the marketplace — pre-configured structures with custom fields optimized for any inventory type.
Overview
Templates provide pre-configured collection structures that you can use as starting points for your inventory. Each template includes custom field definitions, asset types, and organizational patterns optimized for specific use cases.
Gaming Collections
Video games, board games, collectibles
Electronics
Tech inventory and equipment tracking
Books & Media
Libraries, media collections, archives
Business Assets
Office equipment and business inventory
Template Marketplace
Video Game Collection
Track your game library with platform, condition, and value fields
IT Asset Inventory
Manage laptops, monitors, and peripherals with warranty tracking
Personal Library
Organize books with ISBN, author, reading status, and lending
Browsing Templates
Navigate to Market
Open the template marketplace from the main navigation. The screen displays available templates with preview cards.
Filter by Tags
Use tag filters to narrow down templates by category:
List<AssetTemplate> _getFilteredTemplates(List<AssetTemplate> templates) {
return templates.where((t) {
final matchesTags = _selectedTags.isEmpty ||
_selectedTags.every((tag) => t.tags.contains(tag));
return matchesName && matchesTags;
}).toList();
}Search by Name
Use the search bar to find specific templates by name or description.
View Template Details
Click on a template card to see:
Using Templates
Installing from Marketplace
Select Template
Browse the marketplace and find the template that matches your needs.
Preview Fields
Review the custom field definitions included. These define what information you can track for each item.
Add to Library
Click “Save to Library” or “Install” to add the template to your personal collection.
Future<bool> saveTemplateToLibrary(AssetTemplate template) async {
try {
_service.trackDownload(template.id);
// Optimistic update
final index = _marketTemplates.indexWhere((t) => t.id == template.id);
if (index != -1) {
_marketTemplates[index].downloadCount++;
}
await fetchUserLibrary();
notifyListeners();
return true;
} catch (e) {
_errorMessage = e.toString();
return false;
}
}Create Collection
Navigate to your library and use the template to create a new collection with the predefined structure.
Template Components
Custom Field Definitions
Pre-configured fields tailored to the collection type. Example for a video game template:
Asset Type Configuration
Defines the categories and subcategories for organizing items within the collection — ready to use out of the box.
Metadata
“id”: “video_games_collection”,
“name”: “Video Game Collection”,
“tags”: [“gaming”, “collectibles”],
“downloadCount”: 1247
Collections created from templates are independent copies. Changes to the original template won’t affect your existing collections.
Publishing Your Own Templates
Prepare Your Collection
Create a collection with well-defined custom fields and organizational structure. Ensure it represents a reusable pattern others can benefit from.
Open Template Editor
Navigate to Templates → Create or use the “Publicar Plantilla” button.
Configure Template Metadata
{
"id": "unique_template_id",
"name": "Descriptive Name",
"description": "Clear explanation of use case",
"tags": ["category1", "category2"],
"fields": [
// Custom field definitions
]
}Add Custom Fields
Define all custom fields that should be included:
Tag Appropriately
Add relevant tags to help users discover your template. Use existing tags when possible for better organization.
Publish to Marketplace
Future<bool> publishTemplateToMarket(AssetTemplate template) async {
_setLoading(true);
try {
await _service.publishTemplate(template);
_errorMessage = null;
notifyListeners();
return true;
} catch (e) {
_errorMessage = e.toString();
rethrow;
} finally {
_setLoading(false);
}
}Publishing Guidelines
Quality Standards
- Clear purpose for a specific use case
- All essential custom fields included
- Clear, helpful descriptions
- Tested and verified to work
Naming Conventions
- Use descriptive, searchable names
- Avoid generic terms like “My Template”
- Include collection type in the name
- Keep names concise but informative
Field Design
- Only universally applicable fields
- Appropriate field types for validation
- Sensible default values where applicable
- Consider common audience use cases
Managing Your Template Library
Personal Library
Your template library shows all saved templates. Access it to:
- View saved templates
- Create new collections
- Modify template copies
- Remove unused templates
Future<void> fetchUserLibrary() async {
_setLoading(true);
try {
_userLibrary = await _service.getUserLibrary();
_errorMessage = null;
} catch (e) {
_errorMessage = e.toString();
} finally {
_setLoading(false);
}
}Template Updates
Existing collections created from a template are not automatically updated. You’ll need to create a new collection from the updated template or manually apply changes.
Template download counts help identify popular and trusted templates in the marketplace.
Best Practices
For Template Users
- Preview all fields before installing
- Check download counts and ratings for trust signals
- Read descriptions carefully before committing
- Customize field definitions after creation as needed
For Template Creators
- Test with real data before publishing
- Use clear, descriptive names that stand out
- Include comprehensive, universal field sets
- Update templates based on community feedback
Common Use Cases
Video Game Collection
Track your game library with fields for:
- Platform and region
- Physical condition
- Box and manual status
- Purchase information
- Current market value
Book Library
Organize your reading collection with:
- ISBN and publication info
- Author and series
- Edition and printing
- Reading status
- Lending tracking
Electronics Inventory
Manage tech assets with:
- Model and serial numbers
- Warranty information
- Purchase date and price
- Depreciation tracking
- Maintenance schedules
Tool Collection
Track workshop equipment with:
- Brand and model
- Condition ratings
- Location in workshop
- Maintenance logs
- Replacement cost
Troubleshooting
Template Not Loading
- Check your internet connection
- Refresh the marketplace
- Try viewing the template details directly
- Contact the template author if the issue persists
Missing Fields After Installation
- Verify the template includes those fields in the detail view
- Check if you’re viewing the correct collection
- Ensure the template installation completed successfully
- Try reinstalling the template
Next Steps