appclipse
v1.1.2
Published
Front-end framework with a built-in dark mode and full customizability using CSS variables; great for building dashboards and tools
Downloads
12
Maintainers
reashetyrReadme
This is the main branch of the repo, which contains the latest stable release. For the ongoing development, see the develop branch.
AppClipse
Front-end framework with a built-in dark mode and full customizability using CSS variables; great for building dashboards and tools.
- Built-in dark mode—appclipse comes with a built-in, toggleable dark mode, which is one of its most important and defining features.
- Fully customizable using CSS variables—The framework is built entirely using CSS variables (also known as CSS custom properties). There are close to 1,500 CSS variables, which means that almost everything can be customized by overriding a property, making it very easy to theme appclipse to fit your brand. Learn more about customization.
- Great for building dashboards and tools—The components have a very standard look and feel to them, making them suitable for dashboards and tools. Moreover, a lot of importance is placed on components such as forms, navbars, sidebars, dropdowns, toasts, shortcuts, etc. and there are also tons of utilities available.
- Optional JS library—Many of the components found in appclipse are built to work without JavaScript. However, the framework still comes with a powerful JavaScript library with no extra dependencies, such as jQuery.
- Bootstrap like classes—The class names should be instantly familiar to anyone who has used Bootstrap.
- Cross-browser compatibility—Fully supports almost all the browsers under the sun, including really old ones like Internet Explorer 11.
To learn more, go to the documentation.
Quickstart
The quickest way to get started with appclipse is by using the CDN to include the following files:
<!-- appclipse CSS -->
<link href="https://static.appclipse.online/1.1.1/css/appclipse-variables.min.css" rel="stylesheet" />
<!--
Or,
Use the following (no variables, supports IE11):
<link href="https://static.appclipse.online/1.1.2/css/appclipse.min.css" rel="stylesheet" />
-->
<!-- appclipse JS -->
<script src="https://static.appclipse.online/1.1.2/js/appclipse.min.js"></script>Pleast note, the JS file should be placed at the end of the <body> tag. Otherwise, some things may not work as expected. For example, using the onclick="..." event to call one of appclipse's built-in methods will not work unless the JS file is placed at the end of the <body> tag.
Using npm
npm install appclipseAfter installation, the required CSS and JS file can be imported in the following way:
// Include CSS file
require("appclipse/css/appclipse-variables.min.css");
/*
Or,
Include the following (no variables, supports IE11):
require("applipse/css/appclipse.min.css");
*/
// Import JS library
const appclipse = require("appclipse");Please note that manual initialization is required for some components, that is, after the DOM is loaded, the following method needs to be called:
// Call this method after the DOM has been loaded
appclipse.onDOMContentLoaded();This initializes all of the components that require JavaScript, such as dropdowns, custom file inputs, shortcuts, etc.
In this way, appclipse can be used with frameworks that use the virtual DOM, such as React and Vue. For instance, in the case of Vue, the appclipse.onDOMContentLoaded() method would be called inside the mounted() hook of your component.
Using React
If you are using React to call the built-in methods, such as appclipse.toggleSidebar(), please make sure the call is made in a way that binds the correct context. There are two ways to do this:
Using an anonymous method:
<button className="btn" type="button" onClick={() => appclipse.toggleSidebar()}>Using
bind:<button className="btn" type="button" onClick={appclipse.toggleSidebar.bind(appclipse)}>
You can find more details in the React documentation.
Starter template generator
You can use the starter template generator to generate boilerplates for your project. The generator takes your settings and adds the appropriate classes and defines the required containers and elements.
Once again, we recommend reading the documentation, as it contains a lot of examples to help you quickly build websites.
License
appclipse is licensed under the MIT license.
Copyright
Copyright 2023, appclipse UI
Credits
- Halfmoon for creating the base.