{"id":13798194,"url":"https://github.com/mkpaz/atlantafx","last_synced_at":"2025-05-15T01:06:13.784Z","repository":{"id":38335507,"uuid":"475717281","full_name":"mkpaz/atlantafx","owner":"mkpaz","description":"Modern JavaFX CSS theme collection with additional controls.","archived":false,"fork":false,"pushed_at":"2025-02-11T05:26:11.000Z","size":27688,"stargazers_count":980,"open_issues_count":23,"forks_count":71,"subscribers_count":28,"default_branch":"master","last_synced_at":"2025-04-13T22:39:36.756Z","etag":null,"topics":["controls","css","gui","javafx","library","theme"],"latest_commit_sha":null,"homepage":"https://mkpaz.github.io/atlantafx","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mkpaz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-03-30T04:23:47.000Z","updated_at":"2025-04-13T00:57:29.000Z","dependencies_parsed_at":"2024-08-12T12:50:21.325Z","dependency_job_id":"0180d873-4c8a-40df-af11-ee8772fdd8fd","html_url":"https://github.com/mkpaz/atlantafx","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkpaz%2Fatlantafx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkpaz%2Fatlantafx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkpaz%2Fatlantafx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkpaz%2Fatlantafx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mkpaz","download_url":"https://codeload.github.com/mkpaz/atlantafx/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254254040,"owners_count":22039792,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["controls","css","gui","javafx","library","theme"],"created_at":"2024-08-04T00:00:40.220Z","updated_at":"2025-05-15T01:06:08.775Z","avatar_url":"https://github.com/mkpaz.png","language":"Java","funding_links":[],"categories":["Community"],"sub_categories":["Libraries"],"readme":"\u003ch3 align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/mkpaz/atlantafx/master/sampler/icons/icon-rounded-64.png\" alt=\"Logo\"/\u003e\u003cbr/\u003e\n  AtlantaFX\n\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/mkpaz/atlantafx/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/license/mkpaz/atlantafx?style=for-the-badge\" alt=\"License\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/mkpaz/atlantafx/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/mkpaz/atlantafx?5\u0026style=for-the-badge\" alt=\"Latest Version\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/mkpaz/atlantafx/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/mkpaz/atlantafx?style=for-the-badge\" alt=\"Open Issues\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/mkpaz/atlantafx/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/mkpaz/atlantafx?5\u0026style=for-the-badge\" alt=\"Contributors\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.jfx-central.com/libraries/atlantafx\"\u003e\u003cimg src=\"https://img.shields.io/badge/Find_me_on-JFXCentral-blue?logo=googlechrome\u0026logoColor=white\u0026style=for-the-badge\" alt=\"JFXCentral\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\nModern JavaFX CSS theme collection with additional controls.\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003cb\u003e\nSee the \u003ca href=\"https://mkpaz.github.io/atlantafx/\"\u003edocs\u003c/a\u003e for more info.\n\u003c/b\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/mkpaz/atlantafx/master/.screenshots/titlepage/blueprints_primer-light.png\" alt=\"blueprints\"/\u003e\u003cbr/\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/mkpaz/atlantafx/master/.screenshots/titlepage/overview_primer-dark.png\" alt=\"overview\"/\u003e\u003cbr/\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/mkpaz/atlantafx/master/.screenshots/titlepage/toolbar_dracula.png\" alt=\"page\"/\u003e\u003cbr/\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/mkpaz/atlantafx/master/.screenshots/titlepage/notifications_cupertino-dark.png\" alt=\"page\"/\u003e\u003cbr/\u003e\n\u003c/p\u003e\n\n* Flat interface inspired by the variety of Web component frameworks.\n* CSS first! It works with existing JavaFX controls.\n* Two themes in both light and dark variants.\n* Simple and intuitive color system based on the [GitHub Primer guidelines](https://primer.style/design/foundations/color).\n* Fully customizable. Easily change global accent (brand) color or individual control via looked-up color variables.\n* Written in modular [SASS](https://sass-lang.com/). No more digging in 3,500 lines of CSS code.\n* [Custom themes support](https://github.com/mkpaz/atlantafx-sample-theme). Compile your own theme from existing SASS sources.\n* Additional controls that essential for modern GUI development.\n* Beautiful demo app:\n  * Preview all supported themes.\n  * Test every feature of each existing control and check source code directly in the app to learn how to implement it.\n  * Check color palette and modify theme color contrast.\n  * Hot reload. Play with control styles without restarting the whole app.\n  * Showcases to demonstrate real-world project usage.\n\n## Try it out\n\nGrab a **[self-updating download of the Sampler app](https://downloads.hydraulic.dev/atlantafx/sampler/download.html)** for Windows, macOS and Linux, packaged with [Conveyor](https://www.hydraulic.software).\n\nOr download the latest build on the [releases page](https://github.com/mkpaz/atlantafx/releases).\n\n## Getting started\n\n**Requirements:** JavaFX 17+ (because of `data-url` support).\n\nMaven:\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.github.mkpaz\u003c/groupId\u003e\n    \u003cartifactId\u003eatlantafx-base\u003c/artifactId\u003e\n    \u003cversion\u003e2.0.1\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nGradle:\n\n```groovy\nrepositories {\n    mavenCentral()\n}\n\ndependencies {\n    implementation 'io.github.mkpaz:atlantafx-base:2.0.1'\n}\n```\n\nSet a theme:\n\n```java\npublic class Launcher extends Application {\n\n    public static void main(String[] args) {\n        launch(args);\n    }\n\n    @Override\n    public void start(Stage stage) {\n        // find more themes in 'atlantafx.base.theme' package\n        Application.setUserAgentStylesheet(new PrimerLight().getUserAgentStylesheet());\n        Application.setUserAgentStylesheet(new PrimerDark().getUserAgentStylesheet());\n\n        // the rest of the code ...\n    }\n}\n```\n\n### Starter Project\n\nIf you use Maven you can quickly create a new project with AtlantaFX using the [starter](https://github.com/mkpaz/atlantafx-maven-starter):\n\n```sh\ngit clone https://github.com/mkpaz/atlantafx-maven-starter\n```\n\n### Local Installation\n\nIf you don't want to use additional dependencies, you can download compiled CSS themes from the [GitHub Releases](https://github.com/mkpaz/atlantafx/releases). Unpack `AtlantaFX-*-themes.zip` and place it to your project's classpath.\n\nSet CSS theme:\n\n```java\nApplication.setUserAgentStylesheet(/* path to the CSS file */);\n```\n\nOr use Java property:\n\n```text\n-Djavafx.userAgentStylesheetUrl=[URL]\n```\n\n## Custom Themes\n\nAtlantaFX is written in modular SASS, so you can create your own CSS themes using AtlantaFX. \nHere is the sample [repository](https://github.com/mkpaz/atlantafx-sample-theme):\n\n```sh\ngit clone https://github.com/mkpaz/atlantafx-sample-theme\n```\n\n## Contributing\n\nContributions are always welcome! Contributing can mean many things such as participating in discussion or proposing changes. Feel free to open an issue if you've found a bug or want to raise a question, or discuss a possible feature.\n\nPlease, note that AtlantaFX is primarily CSS theme library. Controls and skins support will probably grow over time, but creating yet another control's library is not a main goal.\n\nHere are some areas, where you can help the project:\n\n1. Fixing or reporting bugs. Please, check [OpenJFX bug tracker](https://bugs.openjdk.org/browse/JDK-8294722?jql=project%20%3D%20JDK%20AND%20resolution%20%3D%20Unresolved%20AND%20component%20%3D%20javafx%20%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC) first if the bug you're experiencing isn't related to CSS or custom AtlantaFX control.\n2. Adding or improving control samples, which helps people to learn more about existing controls and we can also test how controls look and work with different themes.\n3. Adding or improving widget samples, which provides basic examples of how to implement some conventional UI components.\n4. Adding or improving app showcases, which demonstrates how AtlantaFX looks in real-world that helps to find more areas for improvement.\n5. Improving docs, because good docs is the face of the project.\n6. Advertising the project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmkpaz%2Fatlantafx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmkpaz%2Fatlantafx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmkpaz%2Fatlantafx/lists"}