aesmail
Kaffy - a quick and flexible admin interface for phoenix applications
Hello guys,
I have finally made it. I created an admin interface for a framework. It’s been on my todo list for years and with the current global pandemic, I kind of had the mindset and time to work on a few things on that list.
The package is in its very early stages, but I started using it for my own projects.
The following is part of the README file.
Kaffy
Extremely simple yet powerful admin interface for phoenix applications
Why another admin interface
Kaffy was created out of a need to have a minimum, flexible, and customizable admin interface
without the need to touch the current codebase. It should work out of the box just by adding some
configs in your config.exs file (with the exception of adding a one liner to your router.ex file).
A few points that encouraged the creation of Kaffy:
- Taking contexts into account.
- Supporting contexts makes the admin interface better organized.
- Can handle as many schemas as necessary.
- Whether we have 1 schema or 1000 schemas, the admin interface should adapt well.
- Have a visually pleasant user interface.
- This might be subjective.
- No generators or generated templates.
- I believe the less files there are the better. This also means it’s easier to upgrade for users when releasing new versions. This might mean some flexibility and customizations will be lost, but it’s a trade-off.
- Existing schemas/contexts shouldn’t have to be modified.
- I shouldn’t have to change my code in order to adapt to the package, the package should adapt to my code.
- Should be easy to use whether with a new project or with existing projects with a lot of schemas.
- Adding kaffy should be as easy for existing projects as it is for new ones.
- Highly flexible and customizable.
- Provide as many configurable options as possible.
- As few dependencies as possible.
- Currently kaffy only depends on phoenix and ecto.
- Simple authorization.
- I need to limit access for some admins to some schemas.
- Minimum assumptions.
- Need to modify a schema’s primary key? Need to hide a certain field? No problem.
All critique, criticism, PRs, and feedback are welcome.
Trending in Announcing
Other Trending Topics
Categories:
Sub Categories:
Forums
Popular Tags
- #ecto
- #liveview
- #troubleshooting
- #learning-elixir
- #deployment
- #library
- #erlang
- #testing
- #genserver
- #mix
- #absinthe
- #remote-other
- #otp
- #plug
- #how-to-question
- #macros
- #postgres
- #channels
- #elixirconf
- #exunit
- #discussion
- #code-sync
- #javascript
- #podcasts
- #onsite
- #dialyzer
- #docker
- #authentication
- #umbrella
- #full-time-contract
- #podcasts-by-brainlid
- #ecto-query
- #elixir-ls
- #phoenix_html
- #iex
- #blog-post
- #graphql
- #genstage
- #ai
- #websockets
- #elixirconf-us
- #supervisor
- #advent-of-code
- #distillery
- #processes
- #api
- #forms
- #metaprogramming
- #security
- #hex










First 10 of 97 Posts!
aesmail
v0.2.0 was just released
Changes
:otp_appconfig is now required (breaking change).otp_app,ecto_repo, androuter.CHANGELOGfile to communicate and track changes easily.and
Thank you for your interest. I’m getting extremely motivated to work on this project with the current response/feedback.
tfwright
I’m seeing an error on the show view for a resource with an embedded struct:
On the list view it displays
[object Object]for what I assume is the offending columnaesmail
Thank you for reporting this. Support for embedded schemas/fields is still not there yet. There’s already an issue on GitHub though so it’s planned. If you could share some generic code here or on GitHub of what your schema looks like that would greatly help.
Thanks.
tfwright
I’ll add it to the Github issue, which probably would have been the proper place to report this in the first place. Sorry, and thank you!
aesmail
v0.2.1 (2020-05-10)
:mapfields for json values.Jason.has_manyorhas_oneassociation.aesmail
v0.3.0 (2020-05-11)
This version has a few bug fixes and a few nice additions.
Mainly:
aesmail
v0.3.1 (2020-05-12)
This update will make things extremely easier for people who have too many records in the database.
Example:
Creating a new
Commentrecord with abelongs_to :post, MyApp.Blog.Postassociation, where we have more than 20 posts. Kaffy will render the following:Once the search button is clicked, a new window will open like the following:
Posts are paginated and searchable. Once you select a post, kaffy will populate its ID in the form and close the window:
antonioparisi
this project looks very promising. well done @aesmail - at the moment I’m using react-admin to handle admin panel on a phoenix application, but happy to start migrating over Kaffy, will check it out soon.
Coming from Ruby 2 years ago, I really missed something similar to active admin on elixir. and Kaffy looks very similar to it
aesmail
Thank you @antonioparisi !
I hope you’ll try and find kaffy useful. Please let me know if you face any issues since I’m very interested in the experience of kaffy being used in existing projects.
And you’re right. My biggest inspirations are the built-in admin from django and activeadmin from rails since I’ve been using both heavily for other projects. I’m trying to combine the best features from these two.
I’m not familiar with react-admin, but it looks awesome! If you don’t mind me asking, what do you like most about it?
I’ll try to use it for a few days and see what good ideas can be implemented in kaffy.
antonioparisi
To be fair I’ve been kinda forced to use react-admin because of the open source availability in terms of admin panels out there at the time when I started. It offers the most reasonable approach to build something straight forward and customisable using react.
Unique big downside of it is that being detached from the APIs (phoenix app), you’ve to build your own endpoints for any action, which to be honest with you is a huge ball-ache
I’ll try Kaffy ASAP since it looks awesome so far in the Phoenix/Elixir world. I’ll give you my feedback on it as soon as I can.
Thanks so much for the amazing work you put on it so far @aesmail keep up the good work!
Last Post!
cgraham
Does Kaffy work with Phoenix 1.8? Couldn’t figure out how to do it. Thx!