See the Architecture of Code
See the architecture of any codebase!
Codeface visualizes the internal composition, dependencies and quality metrics of code to help you understand, improve and monitor it.
IMPORTANT: If you have trouble with the setup, you may write to email@example.com to get personal support.
This version is still an early and minimal stage of a grand future vision. It allows you to:
* See the hierarchical composition of any scope within your codebase
* See the essential dependencies between structural elements on every level: folders, files and code symbols
* See cyclic dependencies (in red) and where they are (artifacts with red borders)
* See the size (lines of code) of each structural element – by visual size as well as by number
* Inspect scopes at all levels – from folders down to properties (thanks to semantic zoom)
* Read the whole codebase along its control flow – from big picture to details (thanks to topological order, dependencies go mostly downwards and to the right)
* Filter all visualizations by a search term
* Save, open and share codebase files. You can load them quickly without an LSP server and even send them to people who have neither the project nor any LSP servers nor technical skills.
* Add support for languages beyond Swift by proving an LSP server
* Being able to switch from reading code to seeing architecture helps making better software faster.
* You understand legacy code, notice red flags, accelerate onboarding, automate documentation, anchor discussions and simply have fun.
* We love software architecture since 1993 and know how communication and quality require visualisation.
* This journey is just beginning. There are loads of ideas and development directions to evolve Codeface.
* Imagine architectural suggestions, more layouts and metrics, real-time updates, a web dashboard, animated navigation and more.
* Be part of the journey and shape Codeface with your own big ideas and feedback: firstname.lastname@example.org
This update is mostly concerned with a big technical modernization under the hood. We migrated all code to the latest Swift concurrency features, which will be necessary anyway with the next major Swift version and which should improve overall robustness.
* Because of an issue in an external framework, the first attempt to connect with LSPService sometimes failed. This is now mostly solved via a workaround in Codeface.
* The display mode picker did not update properly when the display mode was changed via shortcut / menu option.
* The border color of code artifacts sometimes became incorrect after switching macOS between light- and dark mode.
* An empty document now always shows hints about LSPService, whether LSPService runs or not.
* Other minor adjustments to the UI
Ratings and Reviews
Promising, but not there yet
This is a very promising utility that stands to fill an important need -- visualizing large codebases at a higher level of abstraction.
It's not there yet -- a number of usability issues (too numerous to mention here).
If I were the developer, I'd do some Usability testing. Get a few developers on a screenshare, and watch and listen to them as they attempt to use it for the first time, and figure out what to do.
That'd be very revealing. And resisting the temptation to help them out along the way. Watching them struggle to do simple things would form an excellent "to do" list for the next version(s) of the app.
Big thanks to Sebastian for all the effort so far. We'll be keeping an eye on this, to see how it develops.
Developer Response ,
Hey DevDude3000, thanks for your feedback!
I’m really sorry the setup is still that difficult :( It always helps to have an account of the specific issues users run into! So feel free to send an email to hello @ codeface.io.
Anyways, I totally get where you and other users are coming from. Virtually all these usability challenges root in technical hurdles, and I’m working on overcoming them to make everything easier.
I’m also preparing a way to configure LSP servers directly in Codeface without LSPService, which is far from trivial for apps in the App Store, so it will take some time to get working.
Of course, this also means that significant new features are all on hold.
Data Not Collected
The developer does not collect any data from this app.
Privacy practices may vary, for example, based on the features you use or your age. Learn More
- Sebastian Fichtner
- 2.1 MB
- Developer Tools
- Requires macOS 13.0 or later.
- Age Rating
- © Fichtner Flowtoolz 2022