Ash Framework for Phoenix Developers

Preface

Chapter 1: Thinking in Ash

1. 1.1 The Location of Ash In Your Application
2. 1.2 Describe(Model) Your Application
3. 1.3 Data all the way

Chapter 2: The Foundation: Resources and Domains

1. 2.1 Defining the Domain
2. 2.2 Resources
3. 2.3 Generate the Database with a Single Set of Commands
4. 2.4 Ash Resources Are Ecto Schemas
5. 2.5 Ash Resource and Elixir Protocol

Chapter 3: Actions

1. 3.1 Defining Actions on a Resource
2. 3.2 Creating Records
3. 3.2 Reading Record(s) with Ash.read
4. 3.3 Filter Condition With Ash.Query.filter
5. 3.4 Update Records with Ash.update
6. 3.5 Deleting Record(s) with Ash.destroy
7. 3.6 Generic Actions

Chapter 4: Relationships – How to Link Records

1. 4.1 Has Many Relationship
2. 4.2 How to Read Related Data with Ash.Query.load/2
3. 4.3 Belongs To Relationship
4. 4.4 Create Child and Parent at the Same Time
5. 4.5 Many To Many Relationship
6. 4.6 Has One
7. 4.7 Filtering With Relationships
8. 4.8 Retrieving Nested Relationships
9. 4.9 Deleting Records With Related Records

Chapter 5: Calculations and Aggregates

1. 5.1 Calculations
2. 5.2 Aggregates

Chapter 6: Validations

1. 6.1 Preventing Actions on Expired Invitations

Chapter 7: Authorization With Policies

Chapter 8: Code Interfaces

1. 8.1 Declaring Code Interface on a Resource
2. 8.2 Code Interface on the Domain

Part 2 - Wire Ash into Phoenix Applications

Chapter 9: Wiring Ash into Phoenix

1. 9.1 Ash + Phoenix Controller - Building Public Home Page
2. 9.1.1 Basic Home Page Layout
3. 9.1.2 Loading Categories with Aggregates (Best Practice)
4. 9.2 Ash + Phoenix LiveView – Admin CRUD

Chapter 10: LiveView and Real-Time Updates with Ash PubSub

1. 10.1 Enable Ash PubSub Notifications on the Category Resource
2. 10.2 Subscribe to Notifications in LiveView
3. 10.3 Bonus: Even More Efficient Updates (Optional)

Chapter 11: Don’t Repeat Yourself (DRY) in Ash

1. 11.1 DRY Your Forms – One Component for Create & Edit
2. 11.2 DRY Your Read Queries with Preparations
3. 11.3 DRY Your Create/ Update Logic with Changes

Chapter 12: Authentication

1. 12.1.1 Router Scope for Authentication
2. 12.2 Testing Your Application
3. 12.3 Authorization

Chapter 13: Convert Your Application into Multitenant

1. 13.1 Setting Up Teams (Tenant) Resource
2. 13.2 Make this resource multi-tenant
3. 13.3 Creating a Team and Auto-Linking the Owner User to the Team
4. 13.4 Ash Multitenancy: Automating User-Team Associations
5. 13.5 Associate Users with Teams
6. 13.6 Linking the User to the Team
7. 13.7 Setting the Owner’s Current Team
8. 13.8 Logged In User Tenant set
9. 13.9 Speeding Up Our Tests
10. 13.10 Making Liveview Tenant Aware

Chapter 14: Authorization in Ash Multitenancy

1. 14.1 Group Permissions
2. 14.2 Create and Edit Access Group Form
3. 14.3 List Access Group
4. 14.4 Assign Access Group Permission

Chapter 15: Background Jobs with Oban and Ash — Reliable Email Notifications

1. 15.1 Install Dependencies (Igniter Makes This Easy)
2. 15.2 Create the UserNotification Resource (The Heart of the System)
3. 15.3 Global Notify Function — Call It From Anywhere
4. 15.4 Send Real Emails with Swoosh + Mailtrap
5. 15.6 View & Debug Jobs with Oban Web

Chapter 16: CI and Auto Deployment

1. The Method
2. 16.1 Migrations in Production
3. 16.2 Deployment Shell Script
4. 16.3 Reverse Proxy Server Configurations.
5. 16.4 The Github Workflow Configuration

Chapter 17: Understanding Spark and the Extension System

1. 17.1 The Foundation: Code as Data in Elixir
2. 17.2 What is the Abstract Syntax Tree (AST)?
3. 17.3 Using quote to Capture Code as Data
4. 17.4 Using unquote to Inject Values into Quoted Code
5. 17.5 Introducing Spark: The Engine Behind Ash’s DSLs
6. 17.6 How Spark Works: A Simple Example
7. 17.7 A Real Ash Example
8. 17.8 Key Spark Concepts
9. 17.9 Why Spark’s Extension Model is Revolutionary

Chapter 18: Building Your First Ash Extension

1. 18.1 Basic Composition of an Ash Extension
2. 18.2 Start with Just the parent_id Attribute
3. 18.3 Add Relationships and Aggregate
4. 18.4 Usage Example

Chapter 19: Make Your Extension Configurable

1. 19.1 Delete Parent With Its Children

Chapter 20: Publish Your Extension To the World via Hex.pm

1. 20.1 Create Mix Package
2. 20.2 Move Extension Files to the New Package
3. 20.3 Update the Modules Namespace
4. 20.4 Test the Package Locally with Your Ash Application
5. 20.5 Publishing the Package to Hex.pm
6. 20.6 Adding Package Information

Appendix A: Ash Framework Cheat Sheet

1. Setup & Migrations
2. Domain & Resources (minimum)
3. Common Resource Sections
4. CRUD in IEx
5. Query & Filter
6. Relationships (manage_relationship)
7. Common Policy Checks
8. Authorization in Practice
9. Seed Data
10. Useful Ash Modules

Acknowledgments