{"id":15109849,"url":"https://github.com/automattic/simplenote-macos","last_synced_at":"2025-10-23T17:14:36.314Z","repository":{"id":10360071,"uuid":"65415630","full_name":"Automattic/simplenote-macos","owner":"Automattic","description":"Simplenote for macOS","archived":false,"fork":false,"pushed_at":"2025-04-11T09:37:31.000Z","size":31615,"stargazers_count":1514,"open_issues_count":176,"forks_count":171,"subscribers_count":44,"default_branch":"trunk","last_synced_at":"2025-05-07T23:52:51.007Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://simplenote.com","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Automattic.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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":"2016-08-10T20:51:17.000Z","updated_at":"2025-04-30T01:45:56.000Z","dependencies_parsed_at":"2024-01-02T21:56:23.930Z","dependency_job_id":"2a2d7dd2-aea0-48a8-bc2c-5d05279ed031","html_url":"https://github.com/Automattic/simplenote-macos","commit_stats":null,"previous_names":[],"tags_count":53,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Automattic%2Fsimplenote-macos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Automattic%2Fsimplenote-macos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Automattic%2Fsimplenote-macos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Automattic%2Fsimplenote-macos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Automattic","download_url":"https://codeload.github.com/Automattic/simplenote-macos/tar.gz/refs/heads/trunk","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254129490,"owners_count":22019628,"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-09-25T23:24:43.128Z","updated_at":"2025-10-23T17:14:36.309Z","avatar_url":"https://github.com/Automattic.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simplenote for macOS\n\n![Screenshot](https://simplenoteblog.files.wordpress.com/2021/09/gh-screenshot.png)\n\nA Simplenote client for macOS. Learn more about Simplenote at [Simplenote.com](https://simplenote.com).\n\n## Build Instructions\n\n### Download Xcode\n\nAt the moment *Simplenote for macOS* uses Swift 5 and requires Xcode 12 or newer. Xcode can be [downloaded from Apple](https://developer.apple.com/downloads/index.action).*\n\n### Third party tools\n\nWe use a few tools to help with development. To install or update the required dependencies, run the follow command on the command line:\n\n`rake dependencies`\n\n#### Why isn't Sparkle fetched with Swift Package Manager\n\n**TL;DR** We had issues with CocoaPods in the past and haven't had the bandwidth to upgrade to SwiftPM yet.\n\nBack in the CocoaPods days, when we tried to fetch Sparkle using it, the version distributed via CocoaPods didn't support Sandboxing, an important feature in Simplenote macOS at the time.\n\nTo distribute the beta version of Simplenote with Sparkle, we used the [`2.x`](https://github.com/sparkle-project/Sparkle/tree/2.x) branch.\nSee also [this issue in the Sparkle repo](https://github.com/sparkle-project/Sparkle/issues/1523).\n\nSince then, Sparkle officially shipped their version 2, including SwiftPM support, but we haven't had a chance to upgrade yet.\n\nIf there'll be a need to work with Sparkle, ideally we should take the time to upgrade.\nBut just for reference, the process used so far to build from source is contained in the `./Scripts/update-sparkle.sh` script.\n\n#### SwiftLint\n\nWe use [SwiftLint](https://github.com/realm/SwiftLint) to enforce a common style for Swift code. If you plan to write code, SwiftLint is going to be installed when you run a build from Xcode.\n\nNo commit should have lint warnings or errors.\n\n### Open Xcode\n\nLaunch the project by running the following from the command line:\n\n`rake xcode`\n\nThis will ensure any dependencies are ready before launching Xcode.\n\nYou can also open the project by double clicking on `Simplenote.xcworkspace` file, or launching Xcode and choose `File` \u003e `Open` and browse to `Simplenote.xcworkspace`.\n\n## Setup Credentials\n\nSimplenote is powered by the [Simperium Sync'ing protocol](https://www.simperium.com). We distribute **testing credentials** that help us authenticate your application, and verify that the API calls being made are valid.\n\n**⚠️ Please note → We're not accepting any new Simperium accounts at this time.**\n\n\nPlease copy the **testing Simperium credentials** as follows:\n\n```\nmkdir -p Simplenote/Credentials \u0026\u0026 cp Simplenote/SPCredentials-demo.swift Simplenote/Credentials/SPCredentials.swift\n```\n\nThis will allow you to compile and run the app on a device or a simulator.\n\n_Note: Simplenote API features such as sharing and publishing will not work with development builds._\n\n## Style Guidelines\n\n We follow the WordPress iOS Style Guidelines, and we're constantly improving / adopting latest techniques.\n\n - [Swift Standard](https://github.com/wordpress-mobile/swift-style-guide)\n - [ObjC Standard](https://github.com/wordpress-mobile/objective-c-style-guide)\n\n## Contributing\n\nRead our [Contributing Guide](CONTRIBUTING.md) to learn about reporting issues, contributing code, and more ways to contribute.\n\n## License\n\nSimplenote for macOS is an Open Source project covered by the [GNU General Public License version 2](LICENSE.md).\n\nHappy noting!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautomattic%2Fsimplenote-macos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fautomattic%2Fsimplenote-macos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautomattic%2Fsimplenote-macos/lists"}