![\"Logo](\"atui/kernel/assets/logo.png\"){kind=logo}
Front-end library to build your website easier.
\n\n\n\n\n\n\n\n## This library is still under development !\n\nCurrently, there is only beta versions which you can use, but keep in mind this is still in development ! \nAnyway, you can already contribute to the project and give your opinions to help me in the work !\n\n## Download and use ATUI\n\nFor all these links, duplicate these 2 import lines and replace `kernel` by the name of the extension you want to use :\n\n- `MediasPlayer` if you need audio and video players.\n- `SearchServices` if you need search components such as bar, panel and filter.\n\n### By NPM package (recommended)\n\nInstall the NPM package :\n\n```bash\nnpm install @alcapitan/atui\n```\n\nThen, import ATUI in your project using the way you want :\n\n```\n# Links with node_modules\nnode_modules/@alcapitan/atui/atui/kernel/dist/dist.css\nnode_modules/@alcapitan/atui/atui/kernel/dist/dist.js\n# Imports in JavaScript\nimport '@alcapitan/atui/atui/kernel/dist/main.css'\nimport '@alcapitan/atui/atui/kernel/dist/main.js'\n```\n\n### By CDN (for those who don't want to use NPM)\n\nDirectly import ATUI in your project :\n\n```\nhttps://unpkg.com/@alcapitan/atui@0.5.0-beta2/atui/kernel/dist/dist.css\nhttps://unpkg.com/@alcapitan/atui@0.5.0-beta2/atui/kernel/dist/dist.js\n```\n\nHowever, we warn you that using unpkg is quite slow in comparison of NPM install.\n\n### Nightly channel (only for hard developers !)\n\nTo get ATUI from the latest commit in the github repo :\n\n```\nhttps://cdn.jsdelivr.net/gh/alcapitan/atui@dev/atui/kernel/dist/main.css\nhttps://cdn.jsdelivr.net/gh/alcapitan/atui@dev/atui/kernel/dist/main.js\n```\n\n**Warning : `jsdelivr.net` is blocked in Egypt and China, so these links cannot be used. Consequently, we advise you to use a VPN in the absence of a practical way to get content from Github repository in real time.**\n\n## Contributing\n\nATUI is an open-source project that invites collaboration. \nYou can help in the development of the project even without coding ! So you can test ATUI, report bugs, give your opinions and ideas for improvement, and more... \nBefore contributing, please read [CONTRIBUTING.md](https://atui.vercel.app/CONTRIBUTING.md).\nAll your reports must be done in [Issues on GitHub](https://github.com/alcapitan/atui/issues). The roadmap is also in the Issues page.\n\nBesides, you will have to preview ATUI on your computer, you must preview ATUI in HTTP mode using an VScode extension like [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer). This is because some JavaScript functionalities of ATUI cannot work in local file mode. \nBy the way, as ATUI use NPM, you will have to install and update NPM dependencies regularly (about once a week).\n\n## What is this project in a nutshell ?\n\n### The goals of ATUI\n\n- To be as understandable and simple to use as possible for beginners.\n- To provide useful tools to make websites faster to avoid wasting time on tedious things\n\n### Tree structure explanation\n\n- In the `/atui` folder, you will find the source code of ATUI in the `kernel` folder. As well as the officials extensions in the others folders.\n\n## Extensions\n\nOne of ATUI's fun features is extensions. Extensions are additional features, coded to work on ATUI, to give you more possibilities. \nAnyone can create an extension, but you have to respect extension coding standards, and not break the sites that will use them.\n\n### Official extensions\n\n- MediasPlayer : Contains all necessary tools to play music or video.\n- SearchServices : Contains all the necessary tools to search anything by sending a query to a server.\n\n## License & Use of external service\n\nThis project is released under [GNU General Public License](https://atui.vercel.app/LICENSE.md).\n\n### Thanks to some services which I use\n\n- Know the compatibility of web browsers about something : [Caniuse](https://caniuse.com).\n- Icons : [Tabler Icons](https://tabler-icons.io/).\n- Documentations : [MDN Web Docs](https://developer.mozilla.org) & [W3Schools](https://www.w3schools.com).\n- Illustrations : [Pexels](https://pexels.com).\n- Performance measurement and advices for improvement : [Google Insights](https://developers.google.com/speed/pagespeed/insights).\n- Checking HTML code : [W3C Markup Validation Service](https://validator.w3.org).\n- Checking CSS code : [W3C CSS Validation Service](https://jigsaw.w3.org/css-validator).\n- As well as other notable websites, NPM dependencies and even some Instagram accounts...\n","readmeFilename":"README.md"}