https://github.com/apelluru/headless-dam
Cloud-agnostic Headless DAM using Fastly IO for dynamic asset transformation and metadata-driven delivery.
https://github.com/apelluru/headless-dam
dam digital-asset-management headless-architecture headless-dam media-management ruby-on-rails workflow-automation
Last synced: about 2 months ago
JSON representation
Cloud-agnostic Headless DAM using Fastly IO for dynamic asset transformation and metadata-driven delivery.
- Host: GitHub
- URL: https://github.com/apelluru/headless-dam
- Owner: apelluru
- License: mit
- Created: 2026-04-16T14:48:08.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-05-28T11:58:19.000Z (about 2 months ago)
- Last Synced: 2026-05-28T13:24:31.416Z (about 2 months ago)
- Topics: dam, digital-asset-management, headless-architecture, headless-dam, media-management, ruby-on-rails, workflow-automation
- Language: JavaScript
- Homepage:
- Size: 5.69 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Headless DAM (Digital Asset Management)
A modern, high-performance Headless DAM built with a decoupled architecture. This platform utilizes **Ruby on Rails** for
the management engine and **React** for a dynamic, responsive user interface.
---
## 🛠Tech Stack
- **Backend:** Ruby on Rails 7 (API & Business Logic)
- **Frontend:** React 19 & Material UI v9
- **Ruby:** 4.0.3
- **Database:** PostgreSQL 14+
- **Styling:** Emotion 11 (MUI Engine)
---
## 🚀 Getting Started
The project uses a `Makefile` to automate system dependencies and application configuration. Follow these steps in order.
### 1. Initial System Bootstrap
If you are setting up on a new machine, run this to install the required system libraries (Node, Yarn, Ruby Version Manager, and Database Engine).
```bash
make bootstrap
#Note: After this completes, you must restart your terminal or run `source ~/.zshrc` to activate the new Ruby environment.
```
### 2. Application Setup
This command installs all Ruby gems, JavaScript packages, creates the database, and prepares the internal Rails structure.
```bash
make setup
```
### 3. Launch Development Environment
Run the following to start the Rails server and the React compiler simultaneously:
```bash
make dev
```
### Available CommandsCommand
`make bootstrap` Installs system-level packages and Ruby 4.0.3.
`make setup` Installs dependencies and prepares the database.
`make dev` Starts the application and JS watcher.
`make db-setup` Specifically repairs or resets the PostgreSQL database.
`make clean` Wipes temporary logs and asset builds.
`make help` Displays a full list of available automation targets.