Skip to content

Building Pages

A CloudPage is a standard HTML/JavaScript file in a Git repository. Fishbowl loads it into its built-in browser and exposes a JavaScript bridge, fb_client, that the Page uses to read and write Fishbowl data.

Anatomy of a Page

A Page is one HTML file. It declares its title, placement, and window behavior through <meta> tags in the <head>, and does its work in JavaScript:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <meta name="fb_title" content="Receiving Summary">
    <meta name="fb_path" content="Reports:ILC Products">
    <meta name="fb_modules" content="Receiving,Purchase Order">
    <title>Receiving Summary</title>
</head>
<body>
    <h1>Receiving Summary</h1>
    <script>
        // Read Fishbowl data through fb_client — see the references below.
    </script>
</body>
</html>

Declare the Page to Fishbowl

The <meta> tags decide how the Page is titled, where it appears in the Available Pages tree, which modules list it, and how its window opens. See Page metadata for the full set, and HTML reference for the tag details.

Read and write Fishbowl data

The Page calls methods on the injected fb_client object: logging, database queries, REST and legacy API calls, reporting, printing, storage, and more. See the Fishbowl Client Bridge for the complete API, including asynchronous patterns and error handling.

Publish a Page

Commit the HTML file to a repository that CloudPages is configured to pull. The Page loads the next time it is opened — no server access or downtime. See Configuration for connecting a repository.

Reference