1 week ago, 130 views
1 week ago, 91 views
2 weeks ago, 1828 views
3 weeks ago, 537 views
4 weeks ago, 1137 views
We are excited to announce that the alpha version of the LeptonX theme has been released! As stated in this blog post, LeptonX comes in different shapes. For this release, we introduce only ABP based projects with the Angular UI. So, if you are already using the ABP Framework and Angular as the frontend choice, you can integrate these packages into your project today.
The theme has been deployed with two versions: LeptonX-lite (free) and LeptonX (commercial).
Note that this theme currently only works for the Angular UI. Please keep waiting for other UI options.
This section shows how to replace the basic theme (that comes with open source ABP Framework startup template) with the new LeptonX-lite theme.
To add LeptonX-lite
into your project,
@abp/ng.theme.lepton-x
NPM packagenpm install @abp/ng.theme.lepton-x@preview
or
yarn add @abp/ng.theme.lepton-x@preview
angular.json
to replace the existing style with the new one.Replace the following style
{
"input": "node_modules/bootstrap/dist/css/bootstrap.min.css",
"inject": true,
"bundleName": "bootstrap-ltr.min"
},
with
"node_modules/@volo/ngx-lepton-x.lite/styles/sidemenu-layout.min.css",
"node_modules/bootstrap-icons/font/bootstrap-icons.css",
ThemeBasicModule
from app.module.ts
and shared.module.ts
, and import the related modules in app.module.ts
import { ThemeLeptonXModule } from '@abp/ng.theme.lepton-x';
import { SideMenuLayoutModule } from '@abp/ng.theme.lepton-x/layouts';
@NgModule({
imports: [
// ...
ThemeLeptonXModule.forRoot(),
SideMenuLayoutModule.forRoot(),
],
// ...
})
export class AppModule {}
Note: If you employ Resource Owner Password Flow for authorization, you should import the following module as well:
import { AccountLayoutModule } from '@abp/ng.theme.lepton-x/account';
@NgModule({
// ...
imports: [
// ...
AccountLayoutModule.forRoot(),
// ...
],
// ...
})
export class AppModule {}
To change the logos and brand color of the LeptonX
, simply add the following CSS to the styles.scss
:root {
--lpx-logo: url('/assets/images/logo.png');
--lpx-logo-icon: url('/assets/images/logo-icon.png');
--lpx-brand: #edae53;
}
--lpx-logo
is used to place the logo in the menu.--lpx-logo-icon
is a square icon used when the menu is collapsed.--lpx-brand
is a color used throughout the application, especially on active elements.This section shows how to replace the lepton theme (that comes with the ABP Commercial startup template) with the new LeptonX theme.
To add LeptonX
into your existing projects,
@volosoft/abp.ng.theme.lepton-x
NPM packagenpm install @volosoft/abp.ng.theme.lepton-x@preview
or
yarn add @volosoft/abp.ng.theme.lepton-x@preview
angular.json
as follows:Remove the following config from the styles
array since LeptonX provides bootstrap as embedded in its CSS.
{
"input": "node_modules/bootstrap/dist/css/bootstrap.min.css",
"inject": true,
"bundleName": "bootstrap-ltr.min"
},
Add the following ones into the styles
array
{
"input": "node_modules/@volosoft/ngx-lepton-x/styles/themes/dark.css",
"inject": false,
"bundleName": "lepton-x.dark"
},
{
"input": "node_modules/@volosoft/ngx-lepton-x/styles/themes/dim.css",
"inject": false,
"bundleName": "lepton-x.dim"
},
{
"input": "node_modules/@volosoft/ngx-lepton-x/styles/themes/light.css",
"inject": false,
"bundleName": "lepton-x.light"
},
"node_modules/@volosoft/ngx-lepton-x/styles/css/sidemenu-layout.min.css",
"node_modules/bootstrap-icons/font/bootstrap-icons.css",
Three of them are related to the theming and will be loaded during runtime. That's why they are not injected into the head
as a style. Hence, the "inject": false
The fourth one depends on which layout you want to use. For now, there is only sidemenu-layout
available. In the future, there will be many layouts to choose from.
The last one is bootstrap-icons
which are being used throughout the components.
ThemeLeptonModule
from app.module.ts
and shared.module.ts
, and import the following modules in app.module.ts
import { ThemeLeptonXModule } from '@volosoft/abp.ng.theme.lepton-x';
import { AbpSideMenuLayoutModule } from '@volosoft/abp.ng.theme.lepton-x/layouts';
@NgModule({
// ...
imports: [
// ...
ThemeLeptonXModule.forRoot(),
AbpSideMenuLayoutModule.forRoot(), // depends on which layout you choose
// ...
],
// ...
})
export class AppModule {}
Note: If you employ Resource Owner Password Flow for authorization, you should import the following module as well:
import { AccountLayoutModule } from '@volosoft/abp.ng.theme.lepton-x/account';
@NgModule({
// ...
imports: [
// ...
AccountLayoutModule.forRoot({
layout: {
authLayoutImg: '/assets/images/login-bg.jpg',
},
}),
// ...
],
// ...
})
export class AppModule {}
authLayoutImg
: (Optional) If not given, a default image will be placed on the authentication pages.
LeptonX
theme should be up and running within your application. However, you may need to overwrite some css variables based your needs for every theme available as follows::root {
.lpx-theme-dark {
--lpx-logo: url('/assets/images/logo/logo-light.svg');
--lpx-logo-icon: url('/assets/images/logo/logo-light-icon.svg');
--lpx-brand: #edae53;
}
.lpx-theme-dim {
--lpx-logo: url('/assets/images/logo/logo-light.svg');
--lpx-logo-icon: url('/assets/images/logo/logo-light-icon.svg');
--lpx-brand: #f15835;
}
.lpx-theme-light {
--lpx-logo: url('/assets/images/logo/logo-dark.svg');
--lpx-logo-icon: url('/assets/images/logo/logo-dark-icon.svg');
--lpx-brand: #69aada;
}
}
When the user selects a theme, the corresponding CSS class is added to the body
, so you can write specific CSS rules to each theme.
In this blog post, I've explained how to use the alpha version of the new LeptonX theme for ABP-based solutions. Please, keep in mind that this is an alpha version, and we will continue to work on the LeptonX theme. The APIs are bound to change and breaking changes may be introduced in future versions.
We would like you to try it out with the latest version of the ABP Framework and give us feedback at lepton@volosoft.com or open an issue on this repository: https://github.com/volosoft/lepton-theme
nice
Can you please provide update npm/NUGET for MVC, angular Lib final version. I want to switch the new themes on v5.0
I've applied the changes for Lepton-X. Do we have to wait until the release to see any enhancements to the code? Also will the themes be tenant based or can they be user based?
anyone looking for commercial version? we are also looking new themes. but i am doing my own? is theme from abp team or out side?
Thanks nice jobs to the team. The 1.0 stable release will be just after ABP 5.0 which will be released in December with the support of other UI framework like blazor ?
Nice job team! Do you have plan for the final release of LeptonX in commercial ?
Thanks :) 1.0 stable release will be just after ABP 5.0 which will be released in December.
Hi hikalkan, will 1.0 stable also support MVC? :) Thanks and best regards Claus
I have replaced - but still theme showing old on commercial version.
Hello Vijay, Did you remove `ThemeLeptonModule` from `app.module.ts` and `shared.module.ts`?
Very nice. Looking forward to MVC.
Good job!!