Community Articles How to build a simple blog using Vue, Cosmic JS and deploy to Netlify

How to build a simple blog using Vue, Cosmic JS and deploy to Netlify

In this tutorial, I'm going to show you how to create a simple but amazing blog using Vue, Vuex, Cosmic JS and deploy to Netlify. Let’s get started.

TL;DR

Download the GitHub repo.
Check out the demo.

Prerequisites

You will be required to install Node JS and npm before starting. Make sure you already have them installed.

Getting Started:

In this application, we are using Snipcart Vue Blog Demo as starting point. Fork and clone this repository we will look into it later on. First, we will setup the bucket in Cosmic JS. 

Setup bucket:

To create the bucket, login to Cosmic JS and click add 'new bucket'.

Select start from scratch.

Import Bucket Data

Download this bucket.json file. And in Settings -> Import / Export Data, click "Add Import File" and choose the downloaded file. It will import all the Object Types and required data. 

Now we will work on application. 

Integrate Cosmic JS

As bucket is fully setup. Now we will integrate Cosmic JS back-end in forked https://github.com/snipcart/vue-blog-demo repository. First of all, replace package.json with this:

Open the folder in Terminal and do npm install. After doing that, we need to setup Cosmic JS configuration in order to communicate with API. For that, we will create a file index.js in /src/config/ folder. 

After that replace the content of index.js and prod.env.js in /config/ folder respectively.

prod.env.js

Now Cosmic JS configuration is completed. We need to create a .env file at the root of the project. It will load all the variables into process.env.

Changing Vue Resource Plugin to integrate Cosmic JS API

Now app is almost there. We just need to do small tweaks in order to make it work properly. 

Replace src/main.js with the code below. We are changing API endpoint in-order to call Cosmic JS back-end. 

Replace src/plugins/resource/index.js with the code below and I will explain what we are doing here. 

In this modification, we are basically importing config we created before and changing the Endpoint URI for API requests to Cosmic JS. 


BlogFeed

Replace src/resources/BlogFeed.js in-order to map the data from Cosmic JS API to blog feed. We just have to do mapping properly as front-end code is independent of API calls.


BlogPost 

Similarly, replace src/resources/BlogPost.js.It will make single post work perfectly. 

Finalizing 

If you do npm run dev in the terminal, it will work. But before we start deploying, we need to finalize few things. Replace title of the blog, Author Label and Post label in static/api/blog.json. These string will be used in the application. 

As this blog application is static, so if you want to deploy it to Cosmic JS hosting you need to create a simple Node.js Express server. Create server.js in the root of application and copy the below code in that file. 

Everything is done 😃. Additionally, I added TitleComponent to change document.title. You can check the code in my repository


Deployment

Now I will show how you can deploy this application on Cosmic JS hosting and free hosting from Netlify. You need to push this application code to the repository on GitHub. 

Deploying on Cosmic JS Hosting

Go to your bucket in Cosmic JS dashboard and click Settings->Deploy Web App. 

In the new window, enter your repository Url and branch name. After adding all the needed configuration, press "deploy web app". It will be deployed and you will receive email on the successful deployment. You don't need to enter any environment variables here as in Cosmic JS hosting everything is already done for us. 

Deploying on Netlify

Register on Netlify and click "New site from Git". Please choose the Git provider there. In my case, I will use Github. 

After successful authentication, all of your repositories will show up. Pick the right repository. 

Now you need to select your branch and provide some configurations in-order to make it work properly. After selecting branch successfully, in build command enter 'npm run build' and in publish directory enter 'dist'.  Finally, click on 'Show advance' button.

After clicking the advance button, you need to add 3 environment variables. Here we have to do it manually. Cosmic JS hosting do it automatically for us. 

Add COSMIC_BUCKET, COSMIC_READ_KEY & COSMIC_WRITE_KEY there. You can get these values from Settings->Basic Settings. Just paste the values there and press Deploy Site. It will be deployed in few minutes!

Conclusion

This is a simple blog app built using vue, vuex, and Cosmic JS. At the end, we also learned how to deploy this app to Netlify as well as Cosmic JS hosting. I hope you liked the tutorial and will be helpful for you. Cheers!

Was this article helpful?

Thank you! Your input helps us improve our articles and resources. If you have any other questions or comments, please contact support.

You may also like


In this tutorial I'm going to show you how to create a "Tutorials Portfolio" app using a Nuxt.js, and Cosmic JS.
In this tutorial, Cosmic JS co-founder Tony Spiro takes you on a tour of Cosmic JS Webhooks. Learn how webhooks work, see how to easily install integrations with Slack, auto-deploy websites to Netlify, and get an intro to Cosmic JS Functions.
To demonstrate how easy it is to get started with Cosmic JS, we'll utilize the Cosmic JS CLI to quickstart an Angular Ecommerce App. This Angular ecommerce app allows you to process orders from customers and accept Stripe payments for goods and services. Manage inventory in the Cosmic JS Dashboard.
Cosmic JS lets you build one-to-one as well as one-to-many Object Relationships within your Bucket Dashboard. To help you and your team manage content more seamlessly, you can now see your Connected Objects located on the Object’s Edit page in the Dashboard.
Cosmic JS makes it easy to manage content for your Bootstrap applications. In this blog we'll quickstart a Bootstrap Landing Page using the Cosmic CLI. This single page website landing page is built using Node.js and a minimal theme from Start Bootstrap.
Add the power of Algolia search to your Bucket. This Extension enables you to sync your Cosmic JS Objects with Algolia, making your data searchable. Set up automatic syncing to automatically add / edit / remove content from Algolia. Follow the simple steps below to install and setup Algolia.

Ready to Get Started?

No payment info required.
Start Now   Contact Sales