Skip to content

Commit

Permalink
release: 3.1.1
Browse files Browse the repository at this point in the history
  • Loading branch information
NathanWalker committed Jul 22, 2024
1 parent 841f088 commit d8482ed
Show file tree
Hide file tree
Showing 3 changed files with 58 additions and 49 deletions.
12 changes: 12 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,15 @@
<a name="3.1.0"></a>
## [3.1.0](https://github.com/NativeScript/theme/compare/v2.3.4...v3.1.0) (2024-07-22)

### Features

* add custom palettes to _kendo-palettes

### Fixes

* remove warnings for new "Mixed Declarations"
* layout height issue with Angular forms

<a name="2.3.4"></a>
## [2.3.4](https://github.com/NativeScript/theme/compare/v2.3.3...v2.3.4) (2020-12-05)

Expand Down
91 changes: 44 additions & 47 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,78 +1,60 @@
# NativeScript Theme: Core V2
[![npm](https://img.shields.io/npm/v/@nativescript/theme.svg)](https://www.npmjs.com/package/@nativescript/theme)
[![npm](https://img.shields.io/npm/dt/@nativescript/theme.svg?label=npm%20downloads)](https://www.npmjs.com/package/@nativescript/theme)

Home of the core NativeScript Theme 2.0.

- [Breaking Changes](#breaking-changes)
- [Usage](#usage)
- [Usage before NativeScript 6.1](#usage-before-nativescript-61)
- [Setting Dark or Light mode](#setting-dark-or-light-mode)
- [Setting Dark or Light mode from JavaScript](#setting-dark-or-light-mode-from-javascript)
- [More root classes](#more-root-classes)
- [Using Theme variables](#using-theme-variables)
- [CSS variables](#css-variables)
- [Kendo UI ThemeBuilder support](#kendo-ui-themebuilder-support)
- [Theme classes and compatibility](#theme-classes-and-compatibility)
- [Should I use sass or node-sass](#should-i-use-sass-or-node-sass)
- [Screenshots 📸](#screenshots)
- [Changelog 📝](https://github.com/NativeScript/theme/blob/master/CHANGELOG.md)
- [Contributing 🍺](#contributing)
- [Publishing 📚](#publishing)
- [Contributors 💖](#awesome-contributors)
- [License 📋](#license)

## Breaking changes

---
**NOTE**

NativeScript Theme 1.0 to 2.0 migration guide is available [here](MIGRATION-GUIDE.md).

---

* The theme requires 2 files to be loaded - the core theme and a skin on top of it. Read [Usage](#usage) for more info.
* The theme is now **applied using Element selectors**, if you need the old classes approach - it has moved to
.compat CSS/SCSS files, e.g. `core.compat.css` and `blue.compat.css`.
* Theme 2.0 replaces node-sass with **sass** which is more up to date feature-wise and doesn't have a native dependency.
It does still work with node-sass though.
# NativeScript Theme

- [NativeScript Theme](#nativescript-theme)
- [Usage](#usage)
- [Usage before NativeScript 6.1](#usage-before-nativescript-61)
- [Setting Dark or Light mode](#setting-dark-or-light-mode)
- [Setting Dark or Light mode from JavaScript](#setting-dark-or-light-mode-from-javascript)
- [A note of warning](#a-note-of-warning)
- [More root classes](#more-root-classes)
- [Using Theme variables](#using-theme-variables)
- [CSS variables](#css-variables)
- [Kendo UI ThemeBuilder support](#kendo-ui-themebuilder-support)
- [Theme classes and compatibility](#theme-classes-and-compatibility)
- [Should I use sass or node-sass](#should-i-use-sass-or-node-sass)
- [Screenshots](#screenshots)
- [Contributing](#contributing)
- [Publishing](#publishing)
- [Breaking changes](#breaking-changes)
- [Awesome Contributors](#awesome-contributors)
- [LICENSE](#license)

## Usage

The core theme supports light and dark core styling and skins on top of that. To load the core theme styling, just
load the core CSS and its default skin:

```css
@import "~@nativescript/theme/css/core.css";
@import "~@nativescript/theme/css/default.css";
@import "@nativescript/theme/css/core.css";
@import "@nativescript/theme/css/default.css";
```

or alternatively SCSS:

```scss
@import "~@nativescript/theme/core";
@import "~@nativescript/theme/default";
@import "@nativescript/theme/core";
@import "@nativescript/theme/default";
```

If you want, you can choose from several different skins. To do that, you can change the second CSS/SCSS file to the
preferred skin name:

```css
@import "~@nativescript/theme/css/core.css";
@import "~@nativescript/theme/css/blue.css";
@import "@nativescript/theme/css/core.css";
@import "@nativescript/theme/css/blue.css";
```

or

```scss
@import "~@nativescript/theme/core";
@import "~@nativescript/theme/blue";
@import "@nativescript/theme/core";
@import "@nativescript/theme/blue";
```

In order to import just the Theme variables in one of your modules, use this:

```scss
@import "~@nativescript/theme/scss/variables";
@import "@nativescript/theme/scss/variables";
```

It will import just the variables and mixins, without any additional styling.
Expand Down Expand Up @@ -400,6 +382,21 @@ Generate changelog workflow:
7. Tag
8. Push

## Breaking changes

---
**NOTE**

NativeScript Theme 1.0 to 2.0 migration guide is available [here](MIGRATION-GUIDE.md).

---

* The theme requires 2 files to be loaded - the core theme and a skin on top of it. Read [Usage](#usage) for more info.
* The theme is now **applied using Element selectors**, if you need the old classes approach - it has moved to
.compat CSS/SCSS files, e.g. `core.compat.css` and `blue.compat.css`.
* Theme 2.0 replaces node-sass with **sass** which is more up to date feature-wise and doesn't have a native dependency.
It does still work with node-sass though.

## Awesome Contributors

[<img alt="NathanWalker" src="https://avatars.githubusercontent.com/u/457187?v=3&s=117" width="117">](https://github.com/NathanWalker) |[<img alt="TheOriginalJosh" src="https://avatars.githubusercontent.com/u/1486275?v=3&s=117" width="117">](https://github.com/TheOriginalJosh) |[<img alt="tjvantoll" src="https://avatars.githubusercontent.com/u/544280?v=3&s=117" width="117">](https://github.com/tjvantoll) |[<img alt="NathanaelA" src="https://avatars.githubusercontent.com/u/850871?v=3&s=117" width="117">](https://github.com/NathanaelA) |[<img alt="triniwiz" src="https://avatars.githubusercontent.com/u/6695919?v=3&s=117" width="117">](https://github.com/triniwiz) |[<img alt="sis0k0" src="https://avatars.githubusercontent.com/u/7893485?v=3&s=117" width="117">](https://github.com/sis0k0) |
Expand Down
4 changes: 2 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@nativescript/theme",
"version": "2.3.4",
"version": "3.1.0",
"description": "NativeScript Core Theme",
"author": "NativeScript <support@nativescript.org>",
"homepage": "https://www.nativescript.org",
Expand All @@ -25,7 +25,7 @@
"@nativescript/theme": "./src",
"bootstrap": "~4.5.2",
"nativescript-picker": "~2.1.2",
"@nativescript/datetimepicker": "rc",
"@nativescript/datetimepicker": "~3.0.0",
"nativescript-themes": "2.0.1",
"nativescript-ui-autocomplete": "~7.0.0",
"nativescript-ui-sidedrawer": "~9.0.0",
Expand Down

0 comments on commit d8482ed

Please sign in to comment.