{"id":21189008,"url":"https://github.com/mkgithub/devboard","last_synced_at":"2025-03-14T20:41:58.788Z","repository":{"id":63918583,"uuid":"231160619","full_name":"MKGitHub/DevBoard","owner":"MKGitHub","description":"A board with parameters during development \u0026 testing 📺Goodbye console logging!","archived":false,"fork":false,"pushed_at":"2020-02-17T21:51:40.000Z","size":627,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-21T08:34:43.254Z","etag":null,"topics":["app","board","debugger-visualizer","ios","track","xcode"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MKGitHub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-01-01T00:39:25.000Z","updated_at":"2020-02-17T21:51:42.000Z","dependencies_parsed_at":"2023-01-14T14:00:50.927Z","dependency_job_id":null,"html_url":"https://github.com/MKGitHub/DevBoard","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/MKGitHub%2FDevBoard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MKGitHub%2FDevBoard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MKGitHub%2FDevBoard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MKGitHub%2FDevBoard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MKGitHub","download_url":"https://codeload.github.com/MKGitHub/DevBoard/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234955563,"owners_count":18912960,"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":["app","board","debugger-visualizer","ios","track","xcode"],"created_at":"2024-11-20T18:49:32.542Z","updated_at":"2025-01-21T13:21:07.507Z","avatar_url":"https://github.com/MKGitHub.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![MadeInSweden](https://img.shields.io/badge/Made_In-Stockholm_Sweden-blue.svg)](https://en.wikipedia.org/wiki/Stockholm)\n[![Status](https://img.shields.io/badge/Status-Active_and_in_development-blue.svg)](https://github.com/MKGitHub/DevBoard)\n\n[![Version](https://img.shields.io/badge/Version-1.1.0-blue.svg)](https://github.com/MKGitHub/DevBoard)\n[![Carthage](https://img.shields.io/badge/Carthage-1.1.0-blue.svg)](https://github.com/MKGitHub/DevBoard)\n[![SPM](https://img.shields.io/badge/SPM-1.1.0-blue.svg)](https://github.com/MKGitHub/DevBoard)\n[![CocoaPods](https://img.shields.io/badge/CocoaPods-🤬-blue.svg)](https://github.com/MKGitHub/DevBoard)\n\n[![Languages](https://img.shields.io/badge/Languages-Swift_PHP_HTML_JS_CSS-blue.svg)](https://github.com/MKGitHub/DevBoard)\n[![Swift](https://img.shields.io/badge/Swift_Version-5.1.x-blue.svg)](https://github.com/MKGitHub/DevBoard)\n\n\n🌟 Give this repo a star and help its development grow! 🌟\n\n\nDevBoard\n------\nThe console is great for logging and keeping track of whats going on in your app, whether you do logging in Xcode in the Terminal.app or the Console.app. But all that logging is sometimes and often just too much 🤯🤦‍♂️, and you easily loose important information.\n\nHere comes DevBoard to the rescue!\n\nWith DevBoard you can keep track of exactly what you want and see exactly only that! BOOM! Elevator pitch nailed it!\n\n\n![View](https://github.com/MKGitHub/DevBoard/blob/master/Images/view.jpg)\n\n\nHow It Works\n------\n###### Short Story\n* You run the built-in macOS PHP server.\n* You send parameters from your app to a page on the server, which then saves those parameters to a JSON file.\n* That JSON file with those parameters are displayed in another web page.\n\n###### Long Story\nIn the `www` folder double click `Run_DevBoard_Server.command` to run it, this will start the built-in macOS PHP server on `localhost:8888` and use the root directory of the command file.\n\nThen the two web pages in the `www` folder will be opened `DevBoardReceiver.php` and `DevBoardViewer.php`.\n\nThe `DevBoardReceiver.php` page will first launch with example parameters, which will be saved to the `DevBoard_Log.json` file.\n\nThe `DevBoardViewer.php` page will read the JSON file and display those parameters.\n\nYou can now start using DevBoard in your app.\n\nPlease see the provided `DevBoardExampleApp` for Swift.\n\n###### Swift Story\n```swift\n// init\nlet devBoard = DevBoard(host:\"http://localhost:8888\",\n                        autoUpdateTimeInterval:2,\n                        ignoreAllOperations:false)\n\n// set a parameter\ndevBoard.setParameter(atIndex:0, key:\"Button Tapped\",\n                      value:\"Green Button\", color:\"#00FF00\",\n                      actions:[])\n\n// manually send update to server\ndevBoard.sendUpdate()\n\n// At this point… watch your web browser for an update :-)\n\n// if you prefer to use auto updates, subscribe to DevBoard\nvar devBoardSubscriber = devBoard.sink\n{\n    devBoard in\n    devBoard.setParameter(atIndex:1, key:\"Date/Time\", \n                          value:Date().description, color:\"cyan\",\n                          actions:[])\n}\n\n```\n\n###### Setting a Parameter\n* Index: At which index the key/value should be positioned i.e. sort order.\n* Actions: 1 = Apply blinking animation to key-value.\n\n\nRequirements\n------\n* Swift 5.1.x\n* Xcode 11.x\n* Combine framework\n\n\nHow to Install\n------\nDevBoard has a plain \u0026 simple distibution, simply add the `DevBoard.swift` to your project.\n\n* Git: `git clone https://github.com/MKGitHub/DevBoard.git`.\n* Carthage: In your Cartfile add `github \"MKGitHub/DevBoard\"`.\n* Swift Package Manager: Needs swift-tools-version:5.1.\n\n\nRoadmap\n------\n* Add a lot of ready made parameters.\n* * Memory (use, free, warning), Energy, Disk, Battery\n* * Network/Internet info.\n* * What else?\n* Add more support for theming in the viewer page.\n* Add more CSS themes.\n* Add support for playing sound actions.\n* Figure out more cool actions to implement.\n* Add a specific numerical parameter type which can be used to draw diagrams/graphs with historical values.\n* Add a specific numerical parameter type which can be used to draw a range as horizontal or cirular progress.\n* Add support for sending/displaying images.\n* Add support for displaying the navigation stack of an app with screenhots of each view controller (horizontal).\n* Add support for displaying the view hierarchy of an app with screenhots (vertical, z-index).\n* What else?\n\n\nPull Requests\n------\nCurrently not accepting any random pull requests, please create an issue first where a discussion can take place.\n\n\nNotes\n------\nhttps://github.com/MKGitHub/DevBoard\n\nCopyright 2019-2020 Mohsan Khan\n\nLicensed under the Apache License, Version 2.0\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmkgithub%2Fdevboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmkgithub%2Fdevboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmkgithub%2Fdevboard/lists"}