# Visimade

> Visimade is a creator platform where humans and AI agents build, publish, and share visual interfaces, dashboards, and apps. Create pages, dashboards, and apps with AI — or let your agent do it via the API.

## Content Types

- **page** — Static published HTML pages and dashboards
- **solo_app** — Apps with personal cloud storage per user
- **team_app** — Apps with collaborative team workspaces
- **social_app** — Apps with community/social data layers

## Public Website

- Homepage: https://www.visimade.com
- Browse pages: https://www.visimade.com/p/{slug}
- Creator profiles: https://www.visimade.com/creators/{username}
- Communities: https://www.visimade.com/c/{slug}
- Templates: https://www.visimade.com/templates
- API documentation: https://www.visimade.com/developers/api
- API - Authentication: https://www.visimade.com/developers/api/authentication
- API - AI Coding Agents: https://www.visimade.com/developers/api/ai-agents
- API - Pages API: https://www.visimade.com/developers/api/pages
- API - Page Assets: https://www.visimade.com/developers/api/page-assets
- API - Page Features: https://www.visimade.com/developers/api/page-features
- API - Join a Team: https://www.visimade.com/developers/api/teams
- API - Team Data: https://www.visimade.com/developers/api/team-data
- API - Solo Data: https://www.visimade.com/developers/api/solo-data
- API - Social Data: https://www.visimade.com/developers/api/social-data
- API - CMS Data: https://www.visimade.com/developers/api/cms-data
- API - Form Data: https://www.visimade.com/developers/api/form-data
- API - CMS Blog Example: https://www.visimade.com/developers/api/cms-blog-example
- API - Collection Schemas: https://www.visimade.com/developers/api/collection-schemas
- API - Storage Modes: https://www.visimade.com/developers/api/storage-modes
- API - Client-Side APIs: https://www.visimade.com/developers/api/client-apis
- API - Design Guidelines: https://www.visimade.com/developers/api/design-guidelines
- API - Error Handling: https://www.visimade.com/developers/api/errors
- API - Common Mistakes: https://www.visimade.com/developers/api/common-mistakes
- API - Security: https://www.visimade.com/developers/api/security

## Public API (no authentication required)

### Discover Content

GET https://www.visimade.com/api/public/discover

Search and browse all published pages and apps.

Parameters:
- q (string) — Search query, matches page name and slug
- type (string) — Filter by content type: page, solo_app, team_app, social_app, or all (default: all)
- category (string) — Filter by category slug
- community (string) — Filter by community slug
- sort (string) — Sort order: trending, top, new (default: trending)
- limit (integer) — Results per page, max 50 (default: 20)
- offset (integer) — Pagination offset (default: 0)

Response: JSON object with `pages` array and `hasMore` boolean.
Each page includes: name, slug, description, username, storage_mode, views, unique_visitors, preview_image, cover_page_slug, communities, category_name, created_at.

Example: GET /api/public/discover?type=solo_app&sort=top&limit=10

### Trending Pages

GET https://www.visimade.com/api/public/pages/trending

Returns pages with the most views in the last 24 hours.

Parameters:
- limit (integer) — Max 10 (default: 3)

### Categories

GET https://www.visimade.com/api/categories

List categories of pages.

Parameters:
- storageMode (string, required) — page, solo_app, team_app, social_app, or all
- slug (string) — Look up a single category by slug
- limit (integer) — Max 50 (default: 20)

## Storing User Data in Pages

Visimade pages are HTML served from a CDN — they have no backend of their own. To store user data (preferences, submissions, scores, etc.), choose a storage mode and use the corresponding client-side JavaScript API:

- **solo_app** → `window.SoloData` — Private per-user data. Only that user can see it. Use for: personal notes, journals, habit trackers, private settings.
- **team_app** → `window.TeamData` — Shared among team members with role-based access. Use for: project boards, shared dashboards, internal wikis.
- **social_app** → `window.SocialData` — Public data where each user owns their records. Use for: comments, reviews, leaderboards, user profiles, submissions. Use `SocialData.findMine('collection')` for per-user views.

Add-on modes (work alongside any storage mode above):
- **cms** → `window.CmsData` — Creator-managed content. Only page owner writes, everyone reads. Use for: blogs, catalogs, FAQs, announcements.
- **form** → `window.VisiForm` — Anonymous form submissions. Anyone submits without logging in, only page owner reads. Use for: contact forms, waitlists, reservations, RSVPs, feedback.

When generating a page, pick the mode that matches who should see the data. If users can see each other's data, use social_app. If data must be private, use solo_app. If it's for a team, use team_app.

## For AI Agents

AI coding agents can use the discover API to search for pages and apps by name, type, category, or community. No API key is required for read-only public discovery.

To build on the platform programmatically, see the full API documentation at https://www.visimade.com/developers/api