[![Gem Version](https://badge.fury.io/rb/avo.svg)](https://badge.fury.io/rb/avo)
![Tests](https://github.com/avo-hq/avo/workflows/Tests/badge.svg)
![reviewdog](https://github.com/avo-hq/avo/workflows/reviewdog/badge.svg)
[![codecov](https://codecov.io/gh/avo-hq/avo/branch/master/graph/badge.svg?token=Q2LMFE4989)](https://codecov.io/gh/avo-hq/avo)
[![Maintainability](https://api.codeclimate.com/v1/badges/676a0afa2cc79f03aa29/maintainability)](https://codeclimate.com/github/avo-hq/avo/maintainability)

![](https://avohq.io/img/logo-full-stroke-tiny-2x.png)

**Configuration-based, no-maintenance, extendable Ruby on Rails admin**

Avo is a beautiful next-generation framework that empowers you, the developer, to create fantastic admin panels for your Ruby on Rails apps with the flexibility to fit your needs as you grow.

## Get started

**Website**: [avohq.io](https://avohq.io)\
**Documentation**: [docs.avohq.io](https://docs.avohq.io)\
**Twitter**: [avo_hq](https://twitter.com/avo_hq)\
**Community chat**: [discord](https://discord.gg/pkTF6y8)\
**Issue tracker**: [GitHub issues](http://github.com/avo-hq/avo/issues)\
**Discussions and feature requests**: [GitHub issues](http://github.com/avo-hq/avo/discussions)

## Features

  - **Powered by Hotwire** - Rails ❤️  Hotwire
  - **Code driven configuration** - Configure your Rails dashboard entirely by writing Ruby code.
  - **Resource Management** - Create a CRUD interface for Active Record from one command. No more copy-pasting view and controller files around.
  - **Resource Search** - Quickly run a search through one or more resources at once.
  - **Active Storage support** - Amazingly easy, **one-line**, single or multi-file integration with **ActiveStorage**.
  - **Grid view** - Beautiful card layout to showcase your content.
  - **Actions** - Run custom actions to one or more of your resources with as little as pressing a button 💪
  - **Filters** - Write your own custom filters to quickly segment your data.
  - **Keeps your app clean** - You don't need to change your app to use Avo. Drop it in your existing app or add it to a new one and you're done 🙌
  - **Custom fields**- No worries if we missed a field you need. Generate a custom field in a jiffy.
  - **Custom tools** - You need to add a page with something completely new, you've got it!
  - **Authorization** - Leverage Pundit policies to build a robust and scalable authorization system.
  - **Localization** - Have it available in any language you need.
  - **No asset pipeline pollution** - Bring your own asset pipeline.
  - **Dashboard widgets and metrics*** - Customize your dashboard with the tools and analytics you need.
  - **Themable*** - Dress it up into your own colors.

*Features still under development

# Installation
Add this line to your application's `Gemfile`:

```ruby
gem 'avo'
```

And then execute:
```bash
$ bundle install
```

# Quick Purchase

Use [this](https://buy.stripe.com/9AQ6rX0uIbLF2CQdQQ) link to quickly purchase a Pro license to support this project. Thank you 🙏

# Contributing

Please read [CONTRIBUTING.MD](./CONTRIBUTING.MD)

# Upgrade Guide

Please read the [UPGRADE_GUIDE.MD](https://docs.avohq.io/1.0/upgrade.html)

# ✨ Contributors

<a href="https://github.com/avo-hq/avo/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=avo-hq/avo" />
</a>
<!--  https://contrib.rocks -->


![Alt](https://repobeats.axiom.co/api/embed/1481a6a259064f02a7936470d12a50802a9c98a4.svg "Repobeats analytics image")