@elao/admin
v0.2.2
Published
Administration theme
Downloads
31
Readme
Elao admin
Installation
npm install @elao/admin
Usage
In HTML page
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" href="dist/elao-admin.css">
<script src="dist/elao-admin.js" async></script>
</head>
<body>
<script>
window.addEventListener('load', function onLoad() {
const { Collapsible, Drop, Tree, MobileSidebar } = elaoAdmin;
Collapsible.init();
Drop.init();
Tree.init();
MobileSidebar.init();
});
</script>
</body>
</html>
In your app's build:
/* assets/js/app.js */
import { Collapsible, Drop, Tree, MobileSidebar } from '@elao/admin';
// Or with ADM Modules:
const { Collapsible, Drop, Tree, MobileSidebar } = require('@elao/admin');
Collapsible.init();
Drop.init();
Tree.init();
MobileSidebar.init();
Pre-built theme
If you just want to give a try and use the regular theme and component, you can use the pre-built CSS:
/* assets/style/app.scss */
// Import Work Sans font
@import url('https://fonts.googleapis.com/css2?family=Work+Sans:wght@300;400;600&display=swap');
// Import elao/admin main style file.
@import '@elao/admin';
// Customize style with variables
@import './variables';
Custom theme
If you want to customize the theme, and have a more complete experience to build your own components, based on the design system token and Tailwind helpers, you can install the Tailwind dependencies:
npm install -D tailwindcss postcss autoprefixer
Note: If you're using Webpack, you might need to add & configure the
postcss-loader
as well.
and create a tailwind.config.js
file at the root of your project:
import { customize } from '@elao/admin/elao-design-system';
/** @type {import('tailwindcss').Config} */
module.exports = customize({
content: [
'./templates/**/*.html.twig',
'./assets/**/*.js',
// https://tailwindcss.com/docs/content-configuration#working-with-third-party-libraries
'./node_modules/@elao/admin/src/**/*.js',
],
theme: {
extend: {
colors: {
// primary: {
// DEFAULT: 'blue',
// },
},
spacing: {
// '7': '2rem',
},
},
},
});
Create a postcss.config.js
file at the root of your project:
module.exports = {
plugins: {
tailwindcss: {},
autoprefixer: {},
}
}
Then, in your main SCSS file:
// Import Work Sans font
@import url('https://fonts.googleapis.com/css2?family=Work+Sans:wght@300;400;600&display=swap');
@import '@elao/admin/style/style.scss';
CSS Variables
These CSS variables can be used with both pre-build or custom build for simple customization of the theme colors. But you can also fine-tune the theme with the Tailwind configuration instead for more flexibility.
/* assets/style/variables.scss */
:root {
// Primary color is expressed as HSL arguments,
// so the color palette shades can be automatically computed:
--color-primary: 8, 81%, 50%;
--color-primary-hue: 8;
// A value is auto-generated from primary color shades,
// but can still be overridden:
--color-primary-dark: #353c79;
// The following colors are expressed as RGB arguments,
// so it can be used with Tailwind opacity modifier syntax::
--color-success: 0, 204, 153;
--color-warning: 255, 202, 40;
--color-info: 33, 158, 188;
--color-danger: 239, 64, 85;
--color-accessibility-highlight: 237, 238, 250;
--text: #51607a;
--text--dark: #384257;
--text--light: #9e9a9a;
--text--lighter: #bcb7b7;
--border: #faeded;
--border--dark: #f2d2d2;
--background: #fafaff;
--background--dark: #e2e4f7;
--primary-font: 'Work Sans';
}
Features
Contributing
To the library
Install dependencies:
make install
Build with:
make build
Watch with:
make watch
To the demo
Note: For the best experience, you can simply run
make serve
in the root of the project, to serve both the library and the demo application and watching for changes.
The demo application lives inside the demo
folder:
cd demo
It's a Symfony application used to dynamically generate a static site with Stenope with random but realistic data.
It requires:
- PHP 8.0+ and a local Symfony CLI install.
- Node 16+ and NPM 7
In order to boot the application for development purposes, you need to build the library if not already done:
cd ../ && make build && cd demo
Then, you need to start a Symfony web server to expose the application, as well as a Webpack dev-server to build assets with HMR enabled.
➡️ Run the following command in order to start both servers:
make serve
ℹ️ The Symfony server command will display the URL to access the app (usually http://127.0.0.1:8000)
Publish a new version
- Update the version in
package.json
- Create a new release and tag for this version with release
X.Y.Z
and tagvX.Y.Z
.
Fontello
make fontello.push
will open your fontello project on http://fontello.com/.- Modify your font on http://fontello.com/ then click on "Save session".
make fontello.pull
will download your modifications and update project files.- Commit the modifications.