Skip to content

Commit afd2e56

Browse files
chore: make ionic 8 default version (#3600)
* default docs to v8 * freeze ionic 6 docs --------- Co-authored-by: Sean Perkins <[email protected]>
1 parent f8b9bea commit afd2e56

File tree

409 files changed

+941
-933
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

409 files changed

+941
-933
lines changed

docs/theming/dark-mode.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -225,7 +225,7 @@ It is important to pay attention to the specificity if you want to override any
225225
:::
226226

227227
:::info
228-
The contents of Ionic's dark palette can be [viewed on GitHub](https://github.com/ionic-team/ionic-framework/blob/feature-8.0/core/src/css/palettes/dark.scss). The CSS used to apply the **always** dark palette can be found [here](https://github.com/ionic-team/ionic-framework/blob/feature-8.0/core/src/css/palettes/dark.always.scss).
228+
The contents of Ionic's dark palette can be [viewed on GitHub](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.scss). The CSS used to apply the **always** dark palette can be found [here](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.always.scss).
229229
:::
230230

231231
</TabItem>
@@ -244,7 +244,7 @@ It is important to pay attention to the specificity if you want to override any
244244
:::
245245

246246
:::info
247-
The contents of Ionic's dark palette can be [viewed on GitHub](https://github.com/ionic-team/ionic-framework/blob/feature-8.0/core/src/css/palettes/dark.scss). The CSS used to apply the **system** dark palette can be found [here](https://github.com/ionic-team/ionic-framework/blob/feature-8.0/core/src/css/palettes/dark.system.scss).
247+
The contents of Ionic's dark palette can be [viewed on GitHub](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.scss). The CSS used to apply the **system** dark palette can be found [here](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.system.scss).
248248
:::
249249

250250
</TabItem>
@@ -262,7 +262,7 @@ It is important to pay attention to the specificity if you want to override any
262262
:::
263263

264264
:::info
265-
The contents of Ionic's dark palette can be [viewed on GitHub](https://github.com/ionic-team/ionic-framework/blob/feature-8.0/core/src/css/palettes/dark.scss). The CSS used to apply the **class** dark palette can be found [here](https://github.com/ionic-team/ionic-framework/blob/feature-8.0/core/src/css/palettes/dark.class.scss).
265+
The contents of Ionic's dark palette can be [viewed on GitHub](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.scss). The CSS used to apply the **class** dark palette can be found [here](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.class.scss).
266266
:::
267267

268268
</TabItem>

docs/updating/8-0.md

+30-17
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ This guide assumes that you have already updated your app to the latest version
99
:::
1010

1111
:::info Breaking Changes
12-
For a **complete list of breaking changes** from Ionic 7 to Ionic 8, please refer to [the breaking changes document](https://github.com/ionic-team/ionic-framework/blob/feature-8.0/BREAKING.md#version-8x) in the Ionic Framework repository.
12+
For a **complete list of breaking changes** from Ionic 7 to Ionic 8, please refer to [the breaking changes document](https://github.com/ionic-team/ionic-framework/blob/main/BREAKING.md#version-8x) in the Ionic Framework repository.
1313
:::
1414

1515
## Getting Started
@@ -138,24 +138,30 @@ Using the newly imported dark palette mentioned above will also import these new
138138

139139
`--ion-color-step-[number]` usages for **background color** can be migrated by renaming the token to `--ion-background-color-step-[number]`.
140140

141-
**Example**:
141+
**Before**:
142142

143-
```diff
144-
button {
145-
- background: var(--ion-color-step-400);
146-
+ background: var(--ion-background-color-step-400);
147-
}
143+
```html
144+
button { background: var(--ion-color-step-400); }
145+
```
146+
147+
**After**:
148+
149+
```html
150+
button { background: var(--ion-background-color-step-400); }
148151
```
149152

150153
`--ion-color-step-[number]` usages for **text color** can be migrated by renaming the token to `--ion-text-color-step-[number]` and subtracting the number from 1000.
151154

152-
**Example**:
155+
**Before**:
153156

154-
```diff
155-
button {
156-
- color: var(--ion-color-step-400);
157-
+ color: var(--ion-text-color-step-600); /* 1000 - 400 = 600 */
158-
}
157+
```html
158+
button { color: var(--ion-color-step-400); }
159+
```
160+
161+
**After**:
162+
163+
```html
164+
button { color: var(--ion-text-color-step-600); /* 1000 - 400 = 600 */ }
159165
```
160166

161167
The [stepped color generator](../theming/themes#stepped-color-generator) has been updated to generate text and background color stepped variables.
@@ -178,9 +184,16 @@ The `angular.json` file currently imports `src/theme/variables.scss` before impo
178184

179185
We recommend importing the `src/global.scss` file first instead:
180186

181-
```diff
182-
- "styles": ["src/theme/variables.scss", "src/global.scss"],
183-
+ "styles": ["src/global.scss", "src/theme/variables.scss"],
187+
**Before**:
188+
189+
```json
190+
"styles": ["src/theme/variables.scss", "src/global.scss"],
191+
```
192+
193+
**After**:
194+
195+
```json
196+
"styles": ["src/global.scss", "src/theme/variables.scss"],
184197
```
185198

186199
## Required Changes
@@ -246,6 +259,6 @@ iOS >=15
246259

247260
## Need Help Upgrading?
248261

249-
Be sure to look at the [Ionic 8 Breaking Changes Guide](https://github.com/ionic-team/ionic-framework/blob/feature-8.0/BREAKING.md#version-8x). There were several changes to default property and CSS Variable values that developers may need to be aware of. Only the breaking changes that require user action are listed on this page.
262+
Be sure to look at the [Ionic 8 Breaking Changes Guide](https://github.com/ionic-team/ionic-framework/blob/main/BREAKING.md#version-8x). There were several changes to default property and CSS Variable values that developers may need to be aware of. Only the breaking changes that require user action are listed on this page.
250263

251264
If you need help upgrading, please post a thread on the [Ionic Forum](https://forum.ionicframework.com/).

docusaurus.config.js

+4-9
Original file line numberDiff line numberDiff line change
@@ -80,15 +80,10 @@ module.exports = {
8080
return `https://github.com/ionic-team/ionic-docs/edit/main/${versionDocsDirPath}/${docPath}`;
8181
},
8282
exclude: ['README.md'],
83-
lastVersion: 'v7',
83+
lastVersion: 'current',
8484
versions: {
8585
current: {
86-
label: 'v8 (beta)',
87-
banner: 'unreleased',
88-
path: 'v8',
89-
},
90-
v7: {
91-
label: 'v7',
86+
label: 'v8',
9287
},
9388
},
9489
},
@@ -182,8 +177,8 @@ module.exports = {
182177
},
183178
{
184179
type: 'doc',
185-
docId: 'updating/7-0',
186-
label: 'Ionic v7.0.0 Upgrade Guide',
180+
docId: 'updating/8-0',
181+
label: 'Ionic v8.0.0 Upgrade Guide',
187182
position: 'left',
188183
className: 'cta',
189184
},
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"dependencies": {
3-
"@ionic/angular": "next",
4-
"@ionic/core": "next",
3+
"@ionic/angular": "8.0.0",
4+
"@ionic/core": "8.0.0",
55
"@angular/platform-browser-dynamic": "17.3.2"
66
}
77
}

static/code/stackblitz/v8/html/index.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<html>
22

33
<head>
4-
<link rel="stylesheet" type="text/css" href="https://cdn.skypack.dev/@ionic/core@next/css/core.css" />
5-
<link rel="stylesheet" type="text/css" href="https://cdn.skypack.dev/@ionic/core@next/css/ionic.bundle.css" />
4+
<link rel="stylesheet" type="text/css" href="https://cdn.skypack.dev/@ionic/core@8/css/core.css" />
5+
<link rel="stylesheet" type="text/css" href="https://cdn.skypack.dev/@ionic/core@8/css/ionic.bundle.css" />
66
</head>
77

88
<body>
+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
22
"dependencies": {
3-
"@ionic/core": "next"
3+
"@ionic/core": "8.0.0"
44
}
55
}

static/code/stackblitz/v8/react/package-lock.json

+36-36
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

static/code/stackblitz/v8/react/package.json

+2-2
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@
33
"version": "0.1.0",
44
"private": true,
55
"dependencies": {
6-
"@ionic/react": "next",
7-
"@ionic/react-router": "next",
6+
"@ionic/react": "8.0.0",
7+
"@ionic/react-router": "8.0.0",
88
"@types/node": "^20.0.0",
99
"@types/react": "^18.0.9",
1010
"@types/react-dom": "^18.0.4",

0 commit comments

Comments
 (0)