Audora.xyz

High-Quality Podcast Recording Platform

---

Table of Contents

• Features
• Tech Stack
• Project Structure
• Getting Started
• Database Management
• Deployment
• Available Scripts
• Development Tools
• Support
• License

---

Star History

Features

Audora offers a comprehensive set of features for professional podcast recording:

• High-Quality Recording - Studio-grade audio and video recording with multiple input device support
• Real-Time Communication - WebRTC-based peer-to-peer connections with low-latency streaming
• Reliable Uploads - S3 multipart uploads with automatic retry and resume capability
• Professional Processing - Video transcoding, audio normalization, and custom branding
• Security and Privacy - End-to-end encryption with secure room management

---

Tech Stack

Category	Technology
Monorepo	Turborepo
Runtime	Bun
Frontend	Next.js 14
Backend	Express
Real-time	WebRTC, WebSocket
Database	PostgreSQL, Prisma
Storage	AWS S3
Media	FFmpeg
DevOps	Docker, GitHub Actions

---

Project Structure

This monorepo is managed using Turborepo and is structured as follows:

audora/
├── apps/
│   ├── audora-frontend/       # Next.js app for the UI
│   ├── audora-api/            # Express backend for API handling
│   └── audora-signal/         # WebSocket server for real-time communication
├── packages/
│   ├── database/              # Prisma and PostgreSQL setup
│   ├── types/                 # Shared TypeScript types
│   ├── ui/                    # Shared UI components
│   └── typescript-config/     # Shared TypeScript configuration
├── docker/
│   ├── backend.prod.Dockerfile
│   ├── frontend.prod.Dockerfile
│   ├── signal.prod.Dockerfile
│   └── db.docker-compose.yml
├── .github/workflows/         # GitHub Actions CI/CD pipelines
├── turbo.json                 # Turborepo configuration
├── docker-compose.yml         # Full stack Docker Compose
└── package.json               # Root package.json

---

Getting Started

Prerequisites

• Bun v1.2.5 or later
• Node.js v18 or later
• PostgreSQL v14 or later
• Docker and Docker Compose
• FFmpeg (for media processing)

Installation

Clone the repository and install dependencies:

bun install

Copy the environment example file and configure:

cp .env.example .env

Start the database:

bun run db:up

Generate Prisma client and run migrations:

bun run db:deploy

Start the development server:

bun run dev

---

Database Management

Start PostgreSQL

bun run db:up

Stop PostgreSQL

bun run db:down

Run Migrations

bun run db:deploy

Generate Prisma Client

bun run generate

---

Deployment

Docker Compose (Recommended)

Start all services with a single command:

docker compose up -d

This starts:

• PostgreSQL database on port 5432
• Backend API on port 9000
• Signal server on port 8000
• Frontend on port 3000

Individual Docker Builds

# Build all services
docker compose build

# Build specific service
docker compose build frontend
docker compose build backend
docker compose build signal

Production Dockerfiles

Located in the /docker directory:

• backend.prod.Dockerfile - Backend API container
• frontend.prod.Dockerfile - Next.js frontend container
• signal.prod.Dockerfile - WebSocket server container

CI/CD Pipelines

GitHub Actions workflows automate deployment:

• cd_api.yml - Deploys the backend service
• cd_frontend.yml - Deploys the frontend application
• cd_signal.yml - Deploys the WebSocket server

---

Available Scripts

Script	Description
bun run dev	Start all apps in development mode
bun run build	Build all apps for production
bun run start	Start all apps in production mode
bun run start:frontend	Start frontend only
bun run start:api	Start backend API only
bun run start:signal	Start WebSocket server only
bun run db:up	Start PostgreSQL with Docker
bun run db:down	Stop PostgreSQL
bun run db:deploy	Run database migrations
bun run generate	Generate Prisma client
bun run lint	Run linting across all packages
bun run format	Format code with Prettier
bun run check-types	Run TypeScript type checking

---

Development Tools

# Run linting
bun run lint

# Format code
bun run format

# Type checking
bun run check-types

---

Code of Conduct

Please read and follow our Code of Conduct to help keep Audora a welcoming and inclusive space for everyone.

---

License

This project is licensed under the MIT License.

---

Made with care by the audoralabs Team