Build powerful and composable applications with a flexible tool-chain.
A declarative foundation for ambitious Elixir applications. Model your domain, derive the rest.
Get Started

Framework

What is Ash?

Ash Framework is a declarative, resource-oriented application development framework for Elixir. A resource can model anything, like a database table, an external API, or even custom code. Ash provides a rich, and extensive set of tools for interacting with and building on top of these resources. By modeling your application as a set of resources, other tools know exactly how to use them, allowing extensions like AshGraphql and AshJsonApi to provide top tier APIs with minimal configuration. With filtering/sorting/pagination/calculations/aggregations, pub/sub, policy authorization, rich introspection, and much more built-in, and a comprehensive suite of tools to allow you to build your own extensions, the possibilities are endless.

Write it once

Why do developers keep reinventing the wheel?

Every time you start a new app, are you rebuilding features that you've already built many times? Wouldn't it be great if you could just focus on the important parts of an app without reinventing ways to authenticate, add permissions, etc. Ash allows you to not only use patterns in existing extensions, it lets you extract your own patterns into custom extensions. So when you need to do it again in a new application, it's already done. Just wire it up!

Consistency

A place for everything and everything in its place

Ash helps keep things neat and organized by providing good patterns for structuring your application. Over time and with larger teams of different experience levels, patterns change and drift away from each-other across our applications. With that said, nothing in Ash depends on what folders or files you put things in, so you are free to experiment or make the choices that make sense to you.

Spaghetti belongs in the kitchen, not in your codebase. Ash provides the ability to keep all similar parts of your application consistent, making it easy to share an architectural vision while allowing escape hatches to do something different if needed.

Incredibly Powerful

Ash is more than it appears

Ash is more than just auto-generated API or an Admin UI. It’s a fully extensible DSL to model your domain, which creates a declarative, highly introspectable representation. This in turn can be used to derive anything you want.

Ash has built in extensions that allow you to generate Admin UIs or Phoenix LiveView Form helpers, saving a ton of boilerplate. Even going as far as fully swapping data layers, Ash lets you do something traditionally extremely difficult with ease.

Brought to you by

"Through its declarative extensibility, Ash delivers more than you'd expect: Powerful APIs with filtering/sorting/pagination/calculations/aggregations, pub/sub, authorization, rich introspection, GraphQL... It's what empowers this solo developer to build an ambitious ERP!"

Frank Dugan III
System Specialist, SunnyCor Inc.

"I’m constantly blown away with the quality of work and support the Ash community has put into this project. It’s gotten to the point that I can’t imagine starting a new Elixir project that doesn’t use Ash."

Brett Kolodny
Full stack engineer, MEW

"Ash is an incredibly powerful idea that gives Alembic a massive competitive advantage. It empowers us to build wildly ambitious applications for our clients with tiny teams, while consistently delivering the high level of quality that our customers have come to expect."

Josh Price
Technical Director, Alembic

"Ash Framework enabled us to build a robust platform for delivering financial services using bitcoin. Ash proved itself to our team by handling innovative use cases with ease and it continues to evolve ahead of our growing list of needs."

Yousef Janajri
CTO & Co-Founder, Coinbits

"The more I’ve used Ash, the more blown away I am by how much I get out of it – and how little boilerplate I have to write. I’m yet to encounter a situation where I would need to fight the “Ash way” of doing things, but the framework still allows me to choose how I build my software."

Juha Lehtonen
Senior Software Developer

It wouldn't be possible without our amazing community!

Become a contributor

Join our mailing list for (tastefully paced) updates!

Define a resource

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
defmodule Example.Post do
  use AshHq.Resource,
    data_layer: AshPostgres.DataLayer

  resource do
    description "A post is the primary sharable entity in our system"
  end

  postgres do
    table "posts"
    repo Example.Repo
  end

  attributes do
    attribute :text, :string do
      allow_nil? false
      description "The body of the text"
    end

    attribute :visibility, :atom do
      constraints [
        one_of: [:friends, :everyone]
      ]
      description "Which set of users this post should be visible to"
    end
  end

  actions do
    update :react do
      argument :type, Example.Types.ReactionType do
        allow_nil? false
      end

      change manage_relationship(
        :type,
        :reactions,
        type: :append
      )
    end
  end

  relationships do
    belongs_to :author, Example.User do
      allow_nil? true
    end

    has_many :reactions, Example.Reaction
  end
end
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
post = Example.Post.create!(%{
  text: "Declarative programming is fun!"
})

Example.Post.react!(post, %{type: :like})

Example.Post
|> Ash.Query.filter(likes > 10)
|> Ash.Query.sort(likes: :desc)
|> Example.read!()
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
graphql do
  type :post

  queries do
    get :get_post, :read
    list :feed, :read
  end

  mutations do
    create :create_post, :create
    update :react_to_post, :react
  end
end