custom-app-examples's Introduction

Welcome to Storyblok

Storyblok is a visual CMS that works with any framework. Integrate with any app, frontend, or framework. Publish anywhere with an API-first backend. Storyblok’s industry-leading Visual Editor makes it easy for marketing teams to independently create, edit, and collaborate.

Getting Started

Start with your favorite technology

The Storyblok Next.js Ultimate Tutorial

The Storyblok Nuxt Ultimate Tutorial

The Storyblok SvelteKit Ultimate Tutorial

The Storyblok Gatsby Ultimate Tutorial

The Storyblok Laravel Ultimate Tutorial

💡 Try it out for free

Why Storyblok?

Work with any technology: Storyblok’s headless, API-first CMS architecture empowers developers to work with any technology and integrate with any third-party solution.
Scale without limits: Storyblok monitors your applications and automatically scales performance to ensure optimal efficiency and performance.
Flexible data schemas: Storyblok's component-based approach gives you full control over your content structure. You can define your own custom data models with nestable components that can be reused across all your projects.
Publish faster: Marketing and content teams work faster with a Visual Editor enabling them to work independently. No more content tickets in your backlog.
Enterprise security: Ensure data security using one of the most secure, enterprise-grade CMSs available on the market. Storyblok is ISO 27001 certified.
Deliver Better Experiences: Personalize content experiences for different markets, languages, or audience segments using Storyblok's built-in localization tools, or integrate with any third-party solution through API-first integrations.

How it works

A Headless CMS is a back-end-only content management system (CMS) built from the ground up as a content repository that makes content accessible via APIs.

A basic headless CMS Architecture:

Storyblok CMS architecture:

Key Features

Composable Architecture:

APIs: Work with any frontend or third-party integration with GraphQL, REST, and Management API.
Flexible backend: As a headless content management system, Storyblok can manage and serve content for any app or site.
Apps: Add extra functionalities to your space through a suite of custom apps available for free on the Storyblok App Directory, or build your own.
Composable components: Easily define new nestable blocks (such as a hero, grid, or button) or content type blocks (such as an article, landing page, or product page). Create once, reuse everywhere. The limit is your imagination. Learn more.

Streamline Workflows:

Visual editing interface: Storyblok enables non-technical users to build and edit JSON structures with an easy-to-use visual interface. Learn more.
Component Library: Find, access, and edit components directly from the Visual Editor making it easier for teams to collaborate.
Collaboration workflows: Publish faster with inclusive collaboration workflows that give anyone on the team a simple way to make a suggestion or take action.

Audience Experiences:

Image Service: Make apps and websites faster by Transforming, optimizing, and caching images in a CDN. Learn more.
Internationalization: Create personalized content experiences via built-in folder-level and field-level internationalization. Learn more.
Omnichannel Experiences: Storyblok’s headless architecture enables developers to publish content across any digital channel via APIs. Learn more.

Resources

Tutorials
FAQs
Discord
Community
Learning Hub
Clients
SDKs
- JavaScript SDK
- React SDK
- Vue SDK
- Nuxt SDK
- Svelte SDK
- Astro SDK
- Gatsby SDK
Storyblok CLI

We are Hiring

custom-app-examples's People

Contributors

Stargazers

Watchers

custom-app-examples's Issues

last_author may be null in a story object

If we try to get this code working on a clean just created space, all works fine except for the fact thet get fetch stories call seems to return no results. This is unexpected since the default space contains one story with the name 'home'. After some debugging it became clear that this story does NOT have a last_author. So this line

https://github.com/storyblok/custom-app-examples/blob/4f669d7312913a94d864a71ff45886e9a9c4d386/app-nextjs-starter/src/Story.ts#L16C3-L16C17

will discard this as not correct therefore the isStory call also fails and the isStories call will also fail for all arrays that contain this default home story object.

This is confusing for a developer starting with plugin dev.

Since all manually made stories do have a valid last_author field, the best solution would be to tp make the default space initialized with stories that gave some fake last_author with a friendly_name of e.g. "J. Doe" so this code will not break here.

If it is more common to have stories without a last_author (e.g. after importing using the management API), it would be more appropriate to allow this code to work also on empty last_author fields.

Not being able to make the Next JS starter work

Hi! I am trying to make the app-nextjs-starter work.
I followed the steps in the readme. I am not sure if it's ok to use the forwarding URL from ngrok as the base_url. But to test this also deployed the starter and used the Vercel deployment link (i.e.: https://my-storyblok-app.vercel.app) as base_url and also failed.

However, I found this pr and wanted to be sure is a config error and not the pr itself because we are using US authentication.

Expected Behavior

Work as shown in README.md

Current Behavior

I can install the app but when click on it get redirected with error

Steps to Reproduce

Follow readme steps.
Add CLIENT_ID & CLIENT_SECRET as envs from Storyblok app page.
Add urls in app config and to envs

Thanks!! Thrilled to have a next-js starter for apps 😄

Example SEO field plugin referenced in readme no longer exists

The primary readme references a Seo Data App example, however when you visit the link (https://github.com/storyblok/custom-app-examples/tree/main/seo-data-app) it gives a 404 / missing error. It appears this example no longer exists and the readme needs updating to remove it, or to reference a new example.

Recommend Projects

storyblok / custom-app-examples Goto Github PK