Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cosmicjs/cosmicjs-node
*API v2 JavaScript client for Cosmic. See important message in README
https://github.com/cosmicjs/cosmicjs-node
api cms content-management cosmicjs headless-cms javascript nodejs
Last synced: 3 days ago
JSON representation
*API v2 JavaScript client for Cosmic. See important message in README
- Host: GitHub
- URL: https://github.com/cosmicjs/cosmicjs-node
- Owner: cosmicjs
- License: mit
- Created: 2015-07-23T00:42:51.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-06-17T15:59:45.000Z (over 1 year ago)
- Last Synced: 2024-12-18T11:05:49.780Z (10 days ago)
- Topics: api, cms, content-management, cosmicjs, headless-cms, javascript, nodejs
- Language: JavaScript
- Homepage: https://www.cosmicjs.com
- Size: 4.06 MB
- Stars: 275
- Watchers: 13
- Forks: 38
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Cosmic NPM module (dashboard v1)
## IMPORTANT
This package connects to projects on the old Cosmic dashboard and API v2 only. To connect to projects on the [new Cosmic dashboard](https://app.cosmicjs.com/signup) and API v3 use the [Cosmic JavaScript SDK](https://www.npmjs.com/package/@cosmicjs/sdk).
## Content management made simple, fast, and secure.
[Cosmic](https://www.cosmicjs.com/) is a [headless CMS](https://www.cosmicjs.com/headless-cms) (content management system) that provides a web dashboard to create content and an API toolkit to deliver content to any website or application. Build nearly any type of content model using our admin dashboard then deliver your content powered by our [reliable infrastructure](https://cosmicjs.statuspage.io/) and global CDN.
### Save time and launch faster
Avoid the pain of building, configuring, and maintaining your own CMS infrastructure. Cosmic has all of the features you need out of the box optimized and ready. Plug into Cosmic, save time, and launch your content-powered apps faster.
### **Features include**
🛠️  Powerful content modeling
🔍  Flexible queries
⚡  Customized API response
🌎  Localization
🎨  Image optimization
…and more! [See more features →](https://www.cosmicjs.com/features)
## Get started
Start by going to [https://www.cosmicjs.com](https://www.cosmicjs.com/), create your **free account** and set up a project. You can get started from scratch, or start with a [pre-built template](https://www.cosmicjs.com/apps). Then follow the steps below to use this NPM package.
## Install
Install the Cosmic NPM module:
```bash
pnpm install cosmicjs
# OR
yarn add cosmicjs
# OR
npm install cosmicjs
```
## Import
Import Cosmic into your app:
```jsx
const Cosmic = require("cosmicjs")
const api = Cosmic()
```
## Connect
In your [Cosmic admin dashboard](https://app.cosmicjs.com/login) go to _Your Bucket > Settings > API Access_ and get your Bucket slug and read key then set the variables in your app to connect to your Bucket:
```jsx
const bucket = api.bucket({
slug: "YOUR_BUCKET_SLUG",
read_key: "YOUR_BUCKET_READ_KEY",
})
```
## Get content
Delivering content to your app is simple using the `objects.find` method.
**Get multiple Objects**
Use the `objects.find` method and set the `type` property to any Object Type slug. Additional options noted below.
```jsx
const data = await bucket.objects.find({
type: "products" // Object Type slug
})
.props("title,slug,metadata") // response properties
.limit(10) // number of Objects to be returned
```
**Get single Object by slug**
Use the `objects.find` method and set the `slug` property to any Object slug.
```jsx
const data = await bucket.objects.find({
type: "pages", // Object Type slug
slug: "home", // Object slug
locale: "en", // optional, if localization set on Objects
})
.props("title,slug,metadata") // response properties
```
### More examples
For more in-depth guides on getting Cosmic data into your app, you can view these [basic query examples](https://docs.cosmicjs.com/examples/basic-queries). When you are ready to level up, check out [advanced query examples](https://docs.cosmicjs.com/examples/advanced-queries).
## Add content
The Cosmic API is fully CRUD (create, read, update, delete) capable, enabling user-generated content and file uploads. Check out the [add Object](https://docs.cosmicjs.com/examples/add-object) and [add media](https://docs.cosmicjs.com/examples/add-media) examples in the documentation.
## Further documentation
See the [full documentation](https://docs.cosmicjs.com/) for more requests and capabilities.
## Community support
For general help, please refer to [the official Cosmic documentation](https://docs.cosmicjs.com). For additional help, you can use one of these channels to ask a question:
- [Slack](https://www.cosmicjs.com/community) (For live discussions with the Cosmic community and team)
- [GitHub](https://github.com/cosmicjs/cosmicjs-node) (Bug reports, contributions)
- [Twitter](https://twitter.com/cosmicjs) (Get the latest news about Cosmic features and notifications)
- [YouTube](https://www.youtube.com/cosmicjs) (Learn from video tutorials)
## License
This project is published under the [MIT](https://github.com/cosmicjs/cosmicjs-node/blob/HEAD/LICENSE) license.