Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update content #91

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,16 @@ The `Production` workspace is special, as it is used for the submission and dist
Once your project is set up in [Adobe Developer Console](https://developer.adobe.com/console), we need to initialize our app in a local environment.
There are several ways how to do it.

The most basic way is to use AIO CLI with this command:

```shell
demo-extension-project % aio app init
? Select Org:
❯ Alpha Org
Beta Org
Delta Org
```

We will initialize the UI Extension Project using [AIO CLI](https://github.com/adobe/aio-cli).
You may find detailed guide at [Initialize the UI Extension Project using AIO CLI](../../services/aem-cf-console-admin/code-generation#launch-code-generation-during-project-initialization).

Expand Down Expand Up @@ -66,6 +76,10 @@ UI Extensions has default structure and preselected technology stack such as [Re
1. Supply configuration file that will declare application as an [extension](https://developer.adobe.com/app-builder/docs/guides/extensions/).
2. Use `@adobe/uix-guest` library for proper UI Extension initialization and interaction with Adobe service.

## Check your changes during development

When you are doing changes in code you probably would like to check what is result from those changes. You can easly run you local application on Adobe Adobe Experience Manager (AEM). You do not have to publish the code you can just check the result in the cloude instance. Here are steps to do that [Local Preview of UI the Extensions](../preview-extension-locally/).

## Verify your application

After development is done you may check yor application locally (`aio app run`) or at `Stage` or any other workspace at Adobe I/O (`aio app deploy`).
Expand Down
36 changes: 24 additions & 12 deletions src/pages/getting-started/index.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,46 @@
---
title: Getting Started with UI Extensibility
description: Learn basics of UI Extensibility
title: Guides - UI Extensibility
description: Learn what is UI Extensibility and navigate through guides
contributors:
- https://github.com/AdobeDocs/uix
---

# Getting Started
# Getting Started

Begin your journey with UI Extensibility by exploring main capabilities and finding answers to your questions.
The guides below provide you with general information regarding UI Extensibility. For detailed information regarding particular Adobe Service please see `Extensible Services`.

<DiscoverBlock slots="link, text"/>

[What Are UI Extensions](app-builder)
[Get Access](get-access)

Understand the connection between UI Extensibility and App Builder
Discover what is needed to start using UI Extensibility

<DiscoverBlock slots="link, text"/>

[Why Choose UI Extensibility](reason)
[Set Up Local Environment](local-environment)

Know why UI Extensibility may be a good solution for you
Prepare your local environment for UI extension development

<DiscoverBlock slots="link, text"/>

[How It Works](design)
[Create a New Project](creating-project-in-dev-console)

Explore how UI Extensibility works
Discover how to create a project in Adobe Developer Console

<DiscoverBlock slots="link, text"/>

[FAQ](faq)
[Create a New Extension](development-flow)

Know what to expect when creating a UI Extension

Find answers to most frequent questions about UI Extensibility
<DiscoverBlock slots="link, text"/>

[Local Preview](preview-extension-locally)

Discover how to run UI extensions locally and preview result during development

<DiscoverBlock slots="link, text"/>

[Publish and Manage](publication)

Learn to distribute and manage your extension for users
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,9 @@ The final URL for local preview will look like:
https://experience.adobe.com/?ext=https://localhost:9080&repo=<CURTOMER_AEM_HOST>#/@<CUSTOMER_IMS_ORG>/aem/cf/admin/
```

So to create you url you can just open content fragment admin on AEM and modify the url by adding `?devMode=true&ext=https://localhost:9080`. Plese pay attention to the port of you localhost, it can be different then 9080. When you create correct url, you should be able to see your extenstion there.


The system will process these parameters, making it work as if the extension was published.

<InlineAlert variant="info" slots="text" />
Expand Down
46 changes: 0 additions & 46 deletions src/pages/guides/index.md

This file was deleted.

24 changes: 12 additions & 12 deletions src/pages/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,65 +20,65 @@ UI extensions are JavaScript applications built with [Adobe App Builder](https:/

<DiscoverBlock slots="heading, link, text"/>

## Getting Started
## Overview

[What Are UI Extensions](getting-started/app-builder)
[What Are UI Extensions](overview/app-builder)

Understand the connection between UI Extensibility and App Builder

<DiscoverBlock slots="link, text"/>

[Why Choose UI Extensibility](getting-started/reason)
[Why Choose UI Extensibility](overview/reason)

Know why UI Extensibility may be a good solution for you

<DiscoverBlock slots="link, text"/>

[How It Works](getting-started/design)
[How It Works](overview/design)

Explore how UI Extensibility works

<DiscoverBlock slots="link, text"/>

[FAQ](getting-started/faq)
[FAQ](overview/faq)

Find answers to most frequent questions about UI Extensibility

<DiscoverBlock slots="heading, link, text"/>

## Guides
## Getting Started

[Get Access](guides/get-access)
[Get Access](getting-started/get-access)

Discover what is needed to use UI Extensibility

<DiscoverBlock slots="link, text"/>

[Set Up Local Environment](guides/local-environment)
[Set Up Local Environment](getting-started/local-environment)

Prepare your local environment for UI extension development

<DiscoverBlock slots="link, text"/>

[Create a New Project](guides/creating-project-in-dev-console)
[Create a New Project](getting-started/creating-project-in-dev-console)

Discover how to create a project in Adobe Developer Console

<DiscoverBlock slots="link, text"/>

[Create a New Extension](guides/development-flow)
[Create a New Extension](getting-started/development-flow)

Know what to expect when creating a UI Extension

<DiscoverBlock slots="link, text"/>

[Local Preview](guides/preview-extension-locally)
[Local Preview](getting-started/preview-extension-locally)

Discover how to run UI extensions locally and preview result during development

<DiscoverBlock slots="link, text"/>

[Publish and Manage](guides/publication)
[Publish and Manage](getting-started/publication)

Learn to distribute and manage your extension for users

Expand Down
File renamed without changes.
34 changes: 34 additions & 0 deletions src/pages/overview/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
---
title: Overview the UI Extensibility
description: Learn basics of UI Extensibility
contributors:
- https://github.com/AdobeDocs/uix
---

# Overview

Begin your journey with UI Extensibility by exploring main capabilities and finding answers to your questions.

<DiscoverBlock slots="link, text"/>

[What Are UI Extensions](app-builder)

Understand the connection between UI Extensibility and App Builder

<DiscoverBlock slots="link, text"/>

[Why Choose UI Extensibility](reason)

Know why UI Extensibility may be a good solution for you

<DiscoverBlock slots="link, text"/>

[How It Works](design)

Explore how UI Extensibility works

<DiscoverBlock slots="link, text"/>

[FAQ](faq)

Find answers to most frequent questions about UI Extensibility