{"id":13685304,"url":"https://github.com/jwilling/JWFolders","last_synced_at":"2025-05-01T04:30:31.485Z","repository":{"id":2134122,"uuid":"3077521","full_name":"jwilling/JWFolders","owner":"jwilling","description":"Implementation of iOS 6's folders.","archived":false,"fork":false,"pushed_at":"2015-08-07T05:12:01.000Z","size":1780,"stargazers_count":636,"open_issues_count":0,"forks_count":101,"subscribers_count":42,"default_branch":"master","last_synced_at":"2025-04-05T05:04:49.443Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"butterproject/butter-desktop","license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jwilling.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-12-31T00:32:36.000Z","updated_at":"2025-02-18T13:20:49.000Z","dependencies_parsed_at":"2022-08-20T10:10:34.475Z","dependency_job_id":null,"html_url":"https://github.com/jwilling/JWFolders","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwilling%2FJWFolders","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwilling%2FJWFolders/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwilling%2FJWFolders/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwilling%2FJWFolders/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jwilling","download_url":"https://codeload.github.com/jwilling/JWFolders/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251824026,"owners_count":21649785,"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-08-02T14:00:48.535Z","updated_at":"2025-05-01T04:30:31.161Z","avatar_url":"https://github.com/jwilling.png","language":"Objective-C","funding_links":[],"categories":["Objective-C","etc"],"sub_categories":[],"readme":"`JWFolders` is a class that attempts to mimic the folder animation present on the iOS SpringBoard.\n\n##Preview\n`JWFolders` is being used in my commercial application, [QuickWeather](http://itunes.apple.com/us/app/quickweather/id414898317?mt=8). Depicted here is a beta version of the app:\n\n![ExampleFolder](http://www.jwilling.com/serve/github/jwfolders/preview.png)\n\n##Usage\nJust include the entire folder, `JWFolders`, in your project. Import `JWFolders.h` in the class in which you wish to create the folder.\n\n  #import \"JWFolders.h\"\n\nHere's a quick example of how to create a new folder and open it upwards.\n\n```objective-c\nJWFolders *folder = [JWFolders folder];\nfolder.contentView = self.sampleFolder.view;\nfolder.containerView = self.view;\nfolder.position = openPoint;\nfolder.direction = JWFoldersOpenDirectionUp;\nfolder.contentBackgroundColor = [UIColor colorWithPatternImage:[UIImage imageNamed:@\"noise\"]];\nfolder.shadowsEnabled = YES;\nfolder.showsNotch = YES;\n[folder open]; // opens the folder.\n```\n\nAn issue can arise if the folder is set to show the notch, and the `position` is set to a point with an x-coordinate of 0. The notch will appear to be cut off on the left side of the screen. This can be simply resolved by providing a non-zero x-coordinate. Most likely this will be the center of the item from which you present the folder.\n\n**Please check the header file for complete documentation.**\n\n\n##ARC\nThe project currently uses [Automatic Reference Counting](http://clang.llvm.org/docs/AutomaticReferenceCounting.html), which means that if your project does not use ARC there will be memory leaks. There are no plans to create a non-ARC branch at this time.\n\n##Important note\n\nThis library makes use of `CALayer`'s `renderInContext:` method to render the current state of your view into an image. Unfortunately, `renderInContext:` does not take 3D transforms into account. If you would like this to be fixed, please [file a radar](https://bugreport.apple.com).\n\n##License\n`JWFolders` is licensed under the [BSD License](http://www.opensource.org/licenses/bsd-license).\n\n##Todo\n- Finish implementing the animated notch content to complete the effect.\n- Optimize the `renderInContext:` call. I fear this is impossible.\n\n Please feel free to fork the project and improve it as much as possible!\n\n##About Me\nI'm a developer and designer with a passion for great interface design and detail. See my [applications](http://appjon.com/applications.html), learn more [about me](http://appjon.com/about.html), or [get in touch](http://appjon.com/support.html). I'm on Twitter as well: [@willing](http://twitter.com/willing).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjwilling%2FJWFolders","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjwilling%2FJWFolders","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjwilling%2FJWFolders/lists"}