Developer Docs Next.xp 2.x Release Upgrade

Upgrading

Guillotine application

Guillotine version 7 is required if you need to modify graphql schema in your application.

Upgrading from v1.x

Update env vars to:

APP_NAME -> ENONIC_APP_NAME
remove CONTENT_API_MASTER
remove CONTENT_API_DRAFT
add ENONIC_API
API_TOKEN -> ENONIC_API_TOKEN
remove SITE_KEY
add ENONIC_PROJECTS=<repo-name>/site/path[,<lang>:<repo-name>/site/path,...]

Add i18n config block to next.config.js

i18n: {
    locales: ['en', 'no'],
    defaultLocale: 'en',
}

Remove lib-nextxp dependency from your Enonic XP app build.gradle file
Install Next.XP application from Enonic Market

Create config file named com.enonic.app.nextxp.cfg in <xp-home>/config/ folder to change default values and add more configurations:

# uncomment to override default values
# nextjs.default.secret=yourSecret
# nextjs.default.url=http://127.0.0.1:4242
#
# config 'someName'
nextjs.someName.secret=yourSecret
nextjs.someName.url=https://your.next-site.com
#
# config 'anotherName'
nextjs.anotherName.secret=yourOtherSecret
nextjs.anotherName.url=https://your.other-next-site.com
# ...

Remember to update property values with your own data

remove lib-guillotine dependency from build.gradle file of your Enonic XP app
install Guillotine application from Enonic Market

Use Guillotine 7 or higher if you need to extend the graphql schema
Add Next.XP application to your site in every layer and save it
Default configuration will be used automatically for each site. You can change it by going to Next.XP application config in each site and selecting named configurations.

Upgrading

Contents

Guillotine application

Upgrading from v1.x

Contents

Contents