Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
@adminjs/themes
Advanced tools
Readme
Themes let you change the style and default components of your admin panel. There are three elements added to the app by each theme:
component overrides
- React components that replace a subset of overridable components
theme overrides for @adminjs/design-system
- this is merged into the default config, and then user's branding is applied on top
custom CSS styles
- a single global CSS file with additional theme styles
You can add availableThemes configuration option with an array of theme objects (for example imported from @adminjs/themes package) or themes bundled locally with @adminjs/themes
CLI adminjs-themes bundle. The first theme on the list will be active by default. This can be changed with defaultTheme option - specify the ID of a theme - these are usually the same as the named exports.
import AdminJS from 'adminjs'
import { light, dark } from '@adminjs/themes'
new AdminJS({
defaultTheme: 'dark', // same as `dark` from id in the theme index file,
availableThemes: [light, dark],
})
Bundle and style paths are taken from @adminjs/themes if the theme is officially supported by library or can be imported from a local path like:
import path from 'path';
import * as url from 'url';
const __dirname = url.fileURLToPath(new URL('.', import.meta.url));
new AdminJS({
defaultTheme: 'my-custom-theme',
availableThemes: {
id: 'my-custom-theme',
name: 'my custom theme',
overrides: {
colors: {
primary100: '#f00',
},
},
bundlePath: `${path.join(__dirname, `../themes/my-custom-theme`)}/theme.bundle.js`,
stylePath: `${path.join(__dirname, `../themes/my-custom-theme`)}/style.css`,
},
});
Full example available in @adminjs/themes example app.
Additionally, the theme can be configured per-user by returning theme ID in the theme property of the CurrentAdmin object - this should be implemented via the framework plugin, i.e. authenticate function in @adminjs/express. Since you have full control of that object, returned the theme can be selected based on things like user's role or property in the database.
There's no UI control for changing themes, but you can implement this yourself. The general idea is to keep theme ID in the user resource, and add a button that will update the current user record with the selected theme. Alternatively, you can let the user edit their own record and offer a custom select property. Note that for the currentAdmin object to update the user most likely needs to sign in again.
You can create a new theme using @adminjs/themes
cli. After checkout the repository you can register cli on your machine with yarn register:cli
. After that, you can use adminjs-themes
in your command line.
AdminJS Themes CLI provides commands for:
adminjs-themes generate <theme name>
- Generating a new theme with the recommended file structure.adminjs-themes bundle
- Bundling all themes component overrides. You can pass theme ID as an argument to bundle ssingle theme.For more information please use the command adminjs-themes bundle --help
Please see the documentation.
AdminJS is copyrighted © 2023 rst.software. It is a free software, and may be redistributed under the terms specified in the LICENSE file.
We’re an open, friendly team that helps clients from all over the world to transform their businesses and create astonishing products.
FAQs
Themes let you change the style and default components of your admin panel. There are three elements added to the app by each theme:
The npm package @adminjs/themes receives a total of 2,309 weekly downloads. As such, @adminjs/themes popularity was classified as popular.
We found that @adminjs/themes demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.