{"id":13633097,"url":"https://github.com/cadin/panels","last_synced_at":"2025-04-05T09:19:04.755Z","repository":{"id":39945355,"uuid":"392811741","full_name":"cadin/panels","owner":"cadin","description":"Build interactive comics for the Playdate console.","archived":false,"fork":false,"pushed_at":"2025-03-24T01:06:08.000Z","size":949,"stargazers_count":169,"open_issues_count":1,"forks_count":8,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-24T01:33:21.659Z","etag":null,"topics":["comics","playdate"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cadin.png","metadata":{"files":{"readme":"README.md","changelog":null,"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-08-04T20:00:53.000Z","updated_at":"2025-03-24T01:06:12.000Z","dependencies_parsed_at":"2023-02-01T04:01:19.459Z","dependency_job_id":"df9c5649-59e2-45fd-8b93-973f5e3c89da","html_url":"https://github.com/cadin/panels","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cadin%2Fpanels","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cadin%2Fpanels/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cadin%2Fpanels/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cadin%2Fpanels/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cadin","download_url":"https://codeload.github.com/cadin/panels/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247312247,"owners_count":20918396,"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":["comics","playdate"],"created_at":"2024-08-01T23:00:27.501Z","updated_at":"2025-04-05T09:19:04.722Z","avatar_url":"https://github.com/cadin.png","language":"Lua","funding_links":[],"categories":["Open Source Playdate Games \u0026 Example Code"],"sub_categories":["Fonts"],"readme":"# Panels\n\nBuild interactive comics for the Playdate console.\n\n![Banner](./assets/images/panelsBanner.gif)\n\nProvide Panels with a Lua table that describes the sequences in your comic (scroll direction, panel sizes, text, animation and effects) along with your layered graphics. Panels will handle layout, scrolling, animation, and even chapter navigation for you.\n\nComics built with Panels can support these features:\n\n-   layered, parallax scrolling\n-   nested panels\n-   sequences with different scroll directions\n-   manual (crank) scrolling and auto advancing (panel-by-panel)\n-   panel effects like shake and blink\n-   animated transitions between sequences\n-   animations and transitions within panels based on scroll position\n-   animated text layers\n-   panels with fully custom render functions\n-   branching \"choose-your-own-adventure\" storylines\n\n## Documentation\nCheck out the full set of documentation here:\n### [📄 Panels Documentation](//cadin.github.io/panels)\n### [📺 Tutorial Videos](https://www.youtube.com/playlist?list=PLvk_cJkKCihbN4Q61lopDtSQMbx4vNLvv)\n\n## Requirements\n\n-   [Playdate SDK](https://play.date/dev/)\n-   [Playdate Console](https://shop.play.date) (optional)\n\n## Setup\n\n### From Template Project\n\n1. Clone the [Panels Project Template](https://github.com/cadin/panels-project-template).\n    This is a [Template Repo](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template). Click \"Use this template\" to create your own fresh repo with all the contents of the project template.\n2. The template project includes the Panels framework as a git submodule. Be sure to properly [initialize the submodule](https://www.w3docs.com/snippets/git/how-to-clone-including-submodules.html) when cloning the repo.\n3. Start editing table in `myComicData.lua`.\n\n### Manual Setup\n\n1. Clone this repo into your project into a `libraries` folder.\n2. Inside your `main.lua` file import Panels.\n3. Create or import your [`comicData`](http://cadin.github.io/panels/docs/comic-data) table.\n4. Start Panels with your `comicData` table as the sole argument.\n\n### Example `main.lua` File:\n\n```lua\nimport \"libraries/panels/Panels\"\nlocal comicData = {\n    -- comic data goes here...\n}\nPanels.start(comicData)\n```\n\n## Support\n### Get Help\n- 📺 Watch these **[Tutorial Videos](https://www.youtube.com/playlist?list=PLvk_cJkKCihbN4Q61lopDtSQMbx4vNLvv)** to get up to speed quickly.  \n- 🤖 Chat with the **[Panels Partner custom GPT](https://chat.openai.com/g/g-QU76MOCLl-panels-partner)** to get answers to questions about your specific project.\n- 💬 Post your question in the **[Playdate Squad Discord](https://discord.com/channels/675983554655551509/1163630567393341461)**.\n\n\n\n### Feature Requests\n\nAdd feature requests to the [Issues](https://github.com/cadin/panels/issues) page.\n\nInclude a description of the general functionality you need, along with your preferred implementation (if you have one). Please search first to see if someone else has already created an issue for your feature. If so, you can add a vote or comment to show your support.\n\n### Bug Reports\n\nFile bug reports on the [Issues](https://github.com/cadin/panels/issues) page.\n\nEach bug should be listed as a separate issue. Please search first to see if someone else has already filed the bug, and list all steps needed to reproduce the issue in the smallest possible project.\n\n### Contribute\n\nIf you would like to contribute a feature or bug fix please contact me first and let me know which issue you want work on. If there isn't yet an issue for your proposed change, go ahead and write one.\n\n## License\n\nPanels is licensed under a [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).\n\n**TLDR:** You can use this code (or modified versions) to create anything you want, public or private, free or commercial. For attribution, please retain the Panels credit (with URL and QR code) on the Credits page of your game so that others may find their way here.\n\n---\n\n👨🏻‍🦲❤️🛠\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcadin%2Fpanels","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcadin%2Fpanels","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcadin%2Fpanels/lists"}