{"id":13475019,"url":"https://github.com/andrejilderda/joplin-macos-native-theme","last_synced_at":"2025-05-15T09:08:11.759Z","repository":{"id":39409393,"uuid":"357657571","full_name":"andrejilderda/joplin-macos-native-theme","owner":"andrejilderda","description":"Native looking macOS theme for note taking app Joplin","archived":false,"fork":false,"pushed_at":"2025-01-19T15:15:13.000Z","size":3840,"stargazers_count":316,"open_issues_count":11,"forks_count":15,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-05-15T09:08:02.572Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"SCSS","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/andrejilderda.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}},"created_at":"2021-04-13T18:50:25.000Z","updated_at":"2025-05-11T04:21:19.000Z","dependencies_parsed_at":"2023-12-17T22:25:09.482Z","dependency_job_id":"222a052f-ab3f-4ec6-b7df-3c6e6eadcb5b","html_url":"https://github.com/andrejilderda/joplin-macos-native-theme","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrejilderda%2Fjoplin-macos-native-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrejilderda%2Fjoplin-macos-native-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrejilderda%2Fjoplin-macos-native-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrejilderda%2Fjoplin-macos-native-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andrejilderda","download_url":"https://codeload.github.com/andrejilderda/joplin-macos-native-theme/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254310520,"owners_count":22049470,"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":[],"created_at":"2024-07-31T16:01:16.743Z","updated_at":"2025-05-15T09:08:06.744Z","avatar_url":"https://github.com/andrejilderda.png","language":"SCSS","funding_links":[],"categories":["SCSS","others","Themes"],"sub_categories":[],"readme":"# macOS theme for Joplin\n\nNative looking macOS theme for note taking app [Joplin](https://joplinapp.org/) v2.2.4 and above. Also works on non-macOS devices.\n\n![macOS theme for Joplin](/images/macos-theme-for-joplin.png)\n\n- ✨ Completely styled UI, including all controls,\n- 🌜 Choose between light, dark, light with dark sidebar or auto (light/dark based on system preferences),\n- 👌 Use native icons (macOS only) or Phosphor icon family,\n- 👨‍🎨 Easy to customise via Joplin preferences.\n\n## Installation\n\n- Open Joplin preferences › 'Plugins', search for 'macOS theme' and install the theme.\n- Restart Joplin. Enjoy!\n\nMake sure you set ‘Appearance › Theme’ to either ‘Light’ or ‘Dark’. If you experience a flash when switching notebooks sync the Light/Dark-settings under ‘Appearance › Theme’ with the value selected under ‘macOS theme › Appearance’. For more customisation options see below.\n\n## Customisation\n\nAfter installing you can find an extra item named 'macOS theme' in Joplin's preferences. You need to restart Joplin for the changes to apply.\n\n**Mac users**: If you want to use the native icons, download and install SF Pro from the [Apple website here](https://developer.apple.com/fonts/).\n\n## No icons?\n\nIf you have the 'Icon family'-setting set to 'macOS native (SF Pro)' you need to have SF Pro installed from the [Apple website](https://developer.apple.com/fonts/). Note that this only works on macOS-devices.\n\n## Disclaimer\n\n⚠️ Joplin uses styled-components for styling, which makes it incredibly hard to theme the app. A lot of hacky CSS workarounds and `!important`’s were used. These may cause UI issues with future Joplin releases. Since it's just CSS, your data remains safe and you can easily revert the styles.\n\nFeel free to [create an issue](https://github.com/ajilderda/joplin-macos-native-theme/issues) or post a message [on the forum](https://discourse.joplinapp.org/t/plugin-macos-theme-for-joplin) if you run into issues.\n\n## Development\n\nYou can tweak the theme via Joplin's preferences. If you want to go all out follow the following steps to make your own build.\n\nInstall dependencies:\n\n```sh\nnpm install\n```\n\nTo build the plugin:\n\n```sh\nnpm run dist\n```\n\nTo update the plugin framework:\n\n```sh\nnpm run update\n```\n\nTo build just the CSS and watch for changes:\n\n```sh\nnpm run dev\n```\n\nThe generated CSS will be available at: http://localhost:8080/macos-theme-for-joplin.css.\n\n\u003e You may want to refresh the CSS when Joplin gets focus. To do so toggle Joplin's devtools and paste [this script](https://gist.github.com/andrejilderda/f6673f1b1a986b2dc0cd01607acbff26) in the console.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrejilderda%2Fjoplin-macos-native-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandrejilderda%2Fjoplin-macos-native-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrejilderda%2Fjoplin-macos-native-theme/lists"}