Polaris is a front-end web framework for creating responsive UI components, with a focus on simplicity.
Polaris framework is divided into two parts: Core & Plugins
Polaris Core consists of generic components and features that almost every web application needs.
Notice! This repository belongs to Polaris Core only. For more details please check the Main Repository.
Polaris framework is built for front-end web app developers and designers.
- A basic knowledge about HTML, CSS, and JavaScript.
- A basic knowledge about Sass*.
- A basic knowledge about TypeScript*.
- A basic knowledge about webpack*.
*These prerequisites are only required for developers.
In order to use Polaris framework in production you don't need to use any other packages or libraries.
However, to use it in a development environment, it depends on:
- Node.js need to be installed.
- Sass as an npm developement package.
- TypeScript as an npm developement package.
- webpack as an npm developement package.
- webpack CLI as an npm developement package.
- TypeScript loader as an npm developement package.
- inspectpack as an npm developement package.
npm install polaris-core
Coming soon...
You can also clone Polaris using git:
git clone https://github.com/heminsatya/polaris-core.git
Before customization of Polaris framework, you need to know a bit about it's structure:
/dist
/css
/fonts
/images
/js
/src
/scss
/ts
dist folder consists of all compiled files that you can use in production.
src folder consists of all source files that need to be complied during the development.
In order to customize Polaris framework, first you need to download or clone it, then you need to follow a few easy steps:
- Open up your favourite CLI program.
- Change directory to the path where Polaris framework extracted:
cd path-to/polaris-core/
- Install packages by:
npm install
Now, you have everything set-up. You can customize it however you want.
Next step after customization of Polaris is to rebuild CSS, and JavaScript libraries.
To rebuild the CSS libraries run:
npm run css
npm run css-dev
npm run css-rtl
npm run css-rtl-dev
To rebuild the JavaScript libraries run:
npm run js-mod
npm run js
npm run js-dev
I'm Hemin Satya, a freelance programmer.
Please let me know your precious comments, observations, and suggestions: (GitHub) (Twitter)
Thank you all.
Polaris framework is in a beta version and has a long way ahead. It needs contribution to be developed.
I warmly accept and appreciate any contribution requests from anyone who wants to work on this open-source project.
I will do my best to make it something magnificent for all of us. I hope you like it.
If you saw any bugs or mistakes, please let me know. I'll do my best to solve them or at least reduce them asap.