Skip to content

Conversation

@brandyscarney
Copy link
Member

@brandyscarney brandyscarney commented Oct 17, 2025

Resolves #446 in combination with #4322

What is the current behavior?

The Packages & CDN guide has some information on how to get started with Angular, React and Vue but these sections are incomplete. For example, we cover how to add React to an existing app here but it is missing a lot of steps that are documented in the guide here. It doesn't make sense to have the same information in two places.

What is the new behavior?

This PR updates the Packages & CDN guide to redirect out to the Quickstart & Add to Existing guides for the packages, but keeps the CDN content in the Packages & CDN guide. React was the only framework that already had an Add to Existing guide, so this also adds Add to Existing guides for Angular & Vue and moves the content from the Packages & CDN guide to those.

Ionic Packages & CDN Guide Changes

Below is a before & after of the CDN page (right-click and open the image in a new tab to see the images larger):

Before After
production view of packages and cdn page branch view of packages and cdn page

Add to Existing Guide Changes

React

Angular

Vue

Important

The React URL has changed. I set up redirects for this but it will break the JP docs if they are not updated right after. I could leave the old file to remove after the JP docs are updated if desired.


Co-authored-by: feranmiodugbemi <87916077+feranmiodugbemi@users.noreply.github.com>

@vercel
Copy link

vercel bot commented Oct 17, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
ionic-docs Ready Ready Preview Comment Nov 14, 2025 7:59pm

#### 1. Install the Packages

```bash
npm install @ionic/vue @ionic/vue-router vue-router
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The @ionic/vue-router and vue-router installs are here instead of under "Set up Routing" like the React guide because @ionic/vue errors without vue-router being installed and it seemed weird to only install it without also including @ionic/vue-router.

Update `src/app/app.html` to the following:

```html title="src/app/app.html"
<ion-button>Button</ion-button> <ion-datetime></ion-datetime>
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These being on the same line was done by the docs linter.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would really be great if we can figure out how to keep them separate.

@brandyscarney brandyscarney marked this pull request as ready for review November 12, 2025 17:48
@brandyscarney brandyscarney requested a review from a team as a code owner November 12, 2025 17:48
@brandyscarney brandyscarney requested a review from gnbm November 12, 2025 17:48
Copy link
Contributor

@thetaPC thetaPC left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My requested changes also apply to v7 when applicable.

Update `src/app/app.html` to the following:

```html title="src/app/app.html"
<ion-button>Button</ion-button> <ion-datetime></ion-datetime>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would really be great if we can figure out how to keep them separate.

Copy link
Contributor

@thetaPC thetaPC left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, with minor suggestions but not blockers.

Copy link
Contributor

@thetaPC thetaPC left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oops, didn't select approve. Here ya go!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Use Ionic from npm without framework

4 participants