VISIMADE
← Developer Hub

Getting Started

  • Agent Guide
  • Authentication
  • AI Coding Agents

Core APIs

Data APIs

Guides

  • Storage Modes
  • Client-Side APIs
  • Collection Schemas
  • Agent Spec
  • CMS Blog Example
  • Create a Blog (Agent Guide)
  • CMS + Images Guide

Reference

Storage Modes

Choose the right storage mode for your page based on data visibility and access requirements.

ModeData VisibilityWho Can WriteUse Case
pageNo data storageN/AStatic pages, informational content, no user data needed
solo_appPrivate to each userOwner onlyPersonal apps: todo lists, notes, habit trackers, journals
team_appTeam members onlyTeam members (role-based)Team collaboration: project boards, internal wikis, shared dashboards
social_appPublic (everyone can read)Any logged-in user (own records)User submissions, profiles, leaderboards, comments, reviews. Use findMine() for per-user data.
Add-on Data Modes

These modes work alongside any storage mode above. Enable them as additional features on your page.

ModeData VisibilityWho Can WriteUse Case
cmsPublic (everyone can read)Page owner onlyBlogs, product catalogs, FAQs, announcements. Owner publishes, visitors read.
formOwner only (private)Anyone (no login required)Contact forms, waitlists, reservations, RSVPs, feedback, access requests.

Tip: social_app can handle per-user data via findMine() while also supporting shared/public content. Only choose solo_app if the data must be completely hidden from other users.


Configuring Storage Mode

Set the storage mode when creating a page via POST /api/pages, or update it later using the storage config endpoint.

Endpoints
GET

/api/pages/:id/storage-config

Get current storage configuration

PUT

/api/pages/:id/storage-config

Update storage configuration

Example: Update Storage Mode
curl -X PUT \
  -H "Authorization: Bearer vm_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"default_mode": "team_app"}' \
  https://visimade.com/api/pages/123/storage-config
Request Body
FieldTypeDescription
default_modestringStorage mode: page, solo_app, team_app, or social_app
allow_solo_appbooleanAllow solo app data storage
allow_team_appbooleanAllow team app data storage
allow_social_appbooleanAllow social app data storage

On this page

  • Overview
  • Configuring Storage Mode