Storyblok and Angular 13 in 5 min (more or less 😉 )
Storyblok is the first headless CMS that works for developers & marketers alike.
Welcome to Storyblok and Angular 13 in 5 minutes. In this tutorial, we will learn how to integrate our headless CMS, Storyblok, with Angular 13. Following straightforward steps will create all the necessary components and develop the integration with the Storyblok SDK storyblok-js-client .
In the end, you will have a live preview to manage your content in Storyblok:
)
You can clone this tutorial here (opens in a new window)
Let’s start setting up our Angular environment
Requirements
To follow this tutorial please make sure you have everything installed and configured:
- Basic understanding of Angular
- Angular CLI 13 installed
- NodeJS 16 and NPM 8 installed
- A Storyblok account to manage content
Before we get to the code go to Storyblok and create a new space:
)
)
Now we can start and create our project:
ng new angular-tutorial
If all went well, enter the commands:
cd angular-tutorial && ng serve -o
Wait for the server to compile and go to http://localhost:4200
. Here you should see something like this:
)
Great! Now, let's install the Storyblok js client. You should end with version 4.2.1 or superior
npm install storyblok-js-client
And our dynamic component. Here we should get version 10.1 or superior
npm install ng-dynamic-component --save
Awesome! Now, we need to create several files for our project. Don’t worry, we will see how each of them should look
In the end, we should have a file structure similar to this:
)
Ok, let’s start with our Storyblok service ../src/app/services/storyblok.service.ts
. It will be in charge of talking to the Storyblok API, and should look like this:
import { Injectable } from '@angular/core';
import Client from 'storyblok-js-client';
@Injectable({
providedIn: 'root'
})
export class StoryblokService {
private sbClient = new Client({
accessToken: 'Your_Preview_Token' // Add your token here
});
constructor() { }
getStory(slug: string, params?: object): Promise<any> {
return this.sbClient.getStory(slug, params)
.then(res => res.data);
}
getStories(params?: object): Promise<any> {
return this.sbClient.getStories(params)
.then(res => res.data);
}
}
As you can see, we need a preview token. Let's see how we can find it. Let's go to the space we created at the beginning of this tutorial
)
Now let's take a look at ../src/app/directives/storyblok.directive.ts
. This file should look like this
import { Directive, ElementRef, Input } from '@angular/core';
@Directive({
selector: '[appStoryblok]'
})
export class StoryblokDirective {
@Input('appStoryblok') appStoryblok: string;
constructor(private el: ElementRef) {
}
ngOnInit() {
if (typeof this.appStoryblok === 'undefined') {
return;
}
let options = JSON.parse(this.appStoryblok.replace('<!--#storyblok#', '').replace('-->', ''));
this.el.nativeElement.setAttribute('data-blok-c', JSON.stringify(options));
this.el.nativeElement.setAttribute('data-blok-uid', options.id + '-' + options.uid);
}
}
In our ../src/app/app.component.html
, replace the placeholder with:
<div class="root">
<div *ngIf="story.content">
<ndc-dynamic [ndcDynamicComponent]="components[story.content.component]" [ndcDynamicInputs]="story.content">
</ndc-dynamic>
</div>
</div>
Now, the file ../src/app/components.ts
will be in charge of loading our components.
import { PageComponent } from './components/page/page.component';
import { TeaserComponent } from './components/teaser/teaser.component';
import { GridComponent } from './components/grid/grid.component';
import { FeatureComponent } from './components/feature/feature.component';
let Components = {
'page': PageComponent,
'teaser': TeaserComponent,
'grid': GridComponent,
'feature': FeatureComponent
}
export { Components }
Let’s update our ../src/app/app.module.ts
file to include the new components:
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { DynamicModule } from 'ng-dynamic-component';
import { AppComponent } from './app.component';
import { StoryblokService } from './services/storyblok.service';
import { StoryblokDirective } from './directives/storyblok.directive';
import { TeaserComponent } from './components/teaser/teaser.component';
import { GridComponent } from './components/grid/grid.component';
import { PageComponent } from './components/page/page.component';
import { FeatureComponent } from './components/feature/feature.component';
@NgModule({
declarations: [
AppComponent,
PageComponent,
StoryblokDirective,
TeaserComponent,
GridComponent,
FeatureComponent
],
imports: [BrowserModule, DynamicModule],
exports: [BrowserModule, DynamicModule],
providers: [StoryblokService],
bootstrap: [AppComponent],
})
export class AppModule { }
Now, to finish the component configuration, open ../src/app/app.component.ts
and add the following code:
import { Component, OnInit } from '@angular/core';
import { StoryblokService } from './services/storyblok.service';
import { Components } from './components';
@Component({
selector: 'app-root',
templateUrl: './app.component.html',
styleUrls: ['./app.component.css']
})
export class AppComponent implements OnInit {
story = {content: null, name: ''};
components = Components;
constructor(private storyblokService: StoryblokService) {
window.storyblok.init();
window.storyblok.on(['change', 'published'], function() {
location.reload()
});
}
ngOnInit() {
this.storyblokService.getStory('home', {version: 'draft'})
.then(data => this.story = data.story);
}
}
<div>
<div [appStoryblok]="_editable">
<div *ngFor="let blok of body">
<ndc-dynamic *ngIf="components" [ndcDynamicComponent]="components[blok.component]" [ndcDynamicInputs]="blok">
</ndc-dynamic>
</div>
</div>
</div>
import { Component, OnInit, Input } from '@angular/core';
import { StoryblokService } from 'src/app/services/storyblok.service';
@Component({
selector: 'app-page',
templateUrl: './page.component.html',
styleUrls: ['./page.component.css']
})
export class PageComponent implements OnInit {
components: any;
constructor(private storyblok: StoryblokService) {
import('src/app/components').then(cp => {
this.components = cp.Components;
});
}
@Input() body: any[];
@Input() _editable: any;
ngOnInit() {}
}
To have in mind ⚠️
We are using dynamic imports, so we must change our ../tsconfig.json
to target your code to esnext
module
)
<div class="teaser" [appStoryblok]="_editable">
<h1>
{{ headline }}
</h1>
</div>
import { Component, OnInit, Input } from '@angular/core';
@Component({
selector: 'app-teaser',
templateUrl: './teaser.component.html',
styleUrls: ['./teaser.component.css']
})
export class TeaserComponent implements OnInit {
@Input() headline: string;
@Input() _editable: any;
constructor() { }
ngOnInit() {
}
}
<div class="grid" [appStoryblok]="_editable">
<div *ngFor="let blok of columns">
<ndc-dynamic *ngIf="components" [ndcDynamicComponent]="components[blok.component]" [ndcDynamicInputs]="blok">
</ndc-dynamic>
</div>
</div>
import { Component, OnInit, Input } from '@angular/core';
import { StoryblokService } from 'src/app/services/storyblok.service';
@Component({
selector: 'app-grid',
templateUrl: './grid.component.html',
styleUrls: ['./grid.component.css']
})
export class GridComponent implements OnInit {
components: any;
constructor(private storyblok: StoryblokService) {
import('src/app/components').then(cp => {
this.components = cp.Components;
});
}
@Input() columns: any[];
@Input() _editable: any;
ngOnInit() {}
}
<div class="column" [appStoryblok]="_editable">
<h2>{{ name }}</h2>
</div>
import { Component, OnInit, Input } from '@angular/core';
@Component({
selector: 'app-feature',
templateUrl: './feature.component.html',
styleUrls: ['./feature.component.css']
})
export class FeatureComponent implements OnInit {
@Input() name: string;
@Input() _editable: string;
constructor() { }
ngOnInit() {
}
}
<script src="http://app.storyblok.com/f/storyblok-latest.js?t=Q2mIMuV6frKpnmQlOee0rAtt" type="text/javascript"></script>
Add some styles
<link rel="stylesheet" href="https://rawgit.com/DominikAngerer/486c4f34c35d514e64e3891b737770f4/raw/db3b490ee3eec14a2171ee175b2ee24aede8bea5/sample-stylings.css">
Now that everything is set, we can start working in our content
)
Let's add a new preview URL
)
)
)
Remember you can clone this example here (opens in a new window)