Building a JSON Content Bucket — FAQ’s

Written by carsoncgibbons | Published 2017/02/21
Tech Story Tags: web-development | cms | api | json | javascript

TLDRvia the TL;DR App

Let’s take a brief tour of the Cosmic JS Lingo so that you’re prepped to build apps faster and more efficiently. Cosmic JS is an API-first Cloud-based Content Management System that works by decoupling content from code, allowing developers to build apps in any programming language they like, while also allowing content editors to proactively plan and manage content with the forgiveness of a decoupled content API system. Read more about The Benefits of a Decoupled CMS Architecture.

A basic way to think of your Cosmic JS Bucket structure is:

Bucket: Your websiteObject Type: The blog posts on your websiteObject: A blog postMetafield: A picture on your blog postMetafield: The author of your blog post

What’s a Bucket?

A Bucket is the main piece in the Cosmic JS content structure. It’s very flexible and can power the content for an entire website or a portion of a website. Since your Bucket content is delivered via an API endpoint, your Bucket can also power content for any application including iOS, Android, tvOS, Apple Watch, IOT, AR/VR or any other way that you would like to distribute your content.

What’s an Object?

An Object can be a page, a blog post, or anything you want it to be. Cosmic JS gives you the freedom to create and manage content openly and create your own data structure. Each Object allows for the creation of a title, slug, content and Metafields.

Adding an Object — Object Title

Adding an Object — Auto-Generated Slug

Adding an Object’s Content

Adding Metafields To Your Object

Metafields are very powerful pieces of custom data that can be added to objects that can be recursively nested. Current available Metafield types include: text, textarea, HTML textarea, select dropown, file upload, date, object, radio buttons, check boxes and repeater. Your created Metafields are transformed into key/valued Metadata in the API endpoints.

Saving Object Draft | Publishing Object

What’s an Object Type?

An Object Type is any collection of Objects that share a similar function. Pages, articles, projects, etc.

How do I use the Cosmic JS API?

Navigate to Getting Started and Documentation for API Endpoints, Client Libraries, Tutorials and more.

Can I Deploy My Bucket?

Cosmic JS makes it easy to deploy your web app from any public Git repository. Add custom domains and SSL in just a few clicks. Check out our Apps page to see what you can create and deploy in minutes. Cosmic JS is your API, content management and web hosting solution in one!

Cosmic JS is an API-first cloud-based content management platform that makes it easy to manage applications and content. If you have questions about the Cosmic JS API, please reach out to the founders on Twitter or Slack.

Carson Gibbons is the Co-Founder & CMO of Cosmic JS, an API-first Cloud-based Content Management Platform that decouples content from code, allowing devs to build slick apps and websites in any programming language they want.


Written by carsoncgibbons | Director of Sales @ Preciate Formerly Co-Founder @ Cosmic JS Y Combinator W19 Batch
Published by HackerNoon on 2017/02/21