An open API service indexing awesome lists of open source software.

https://github.com/jonbeatz/mystudiochannel

Professional creator platform - studio-style websites for content creators. Next.js + Payload CMS.
https://github.com/jonbeatz/mystudiochannel

creator-platform my-studio-channel nextjs payload-cms tailwindcss

Last synced: 8 days ago
JSON representation

Professional creator platform - studio-style websites for content creators. Next.js + Payload CMS.

Awesome Lists containing this project

README

          

# My Studio Channel (MSC) โ€” Next-Gen Creator Platform

## ๐Ÿš€ Quick Start for Contributors

### Prerequisites
- **Node.js** 18, 20, 22, or 24
- **Git**

### One-command setup

```bash
git clone https://github.com/jonbeatz/MyStudioChannel.git
cd MyStudioChannel
npm run setup:dev
```

This command will:
- **Install** all dependencies
- **Create** your `.env.local` file
- **Optionally seed** the database with sample data
- **Run a health check** to ensure everything is ready

After setup, run `npm run dev` and visit [http://localhost:3000](http://localhost:3000)

---

**The production-hardened development operating system for creator platforms.**
**Build studio-style websites with a visual command center,**
**Next.js 15 stability, and the custom MSC PRO ENGINE.**

![My Studio Channel Hero](.cursor/design-references/MSC-Pages/MSC-Pages-v1.jpg)

[![Next.js 15](https://img.shields.io/badge/Next.js-15-black?logo=next.js)](https://nextjs.org/)
[![Payload CMS 3](https://img.shields.io/badge/Payload_CMS-3-green?logo=payload)](https://payloadcms.com/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5-blue?logo=typescript)](https://www.typescriptlang.org/)
[![Tailwind CSS 4](https://img.shields.io/badge/Tailwind_CSS-4-38B2AC?logo=tailwind-css)](https://tailwindcss.com/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Cursor](https://img.shields.io/badge/Cursor-Agent_Ready-8E44AD?logo=cursor)](https://cursor.com/)
[![Troubleshooting](https://img.shields.io/badge/Troubleshooting-Active_Guide-red?logo=github)](.cursor/docs/DEPLOYMENT-TROUBLESHOOTING.md)
![Version](https://img.shields.io/badge/version-6.0.0-blue)
![Deploy](https://img.shields.io/badge/deploy-ftps-success)

---

> ๐Ÿ”ฎ **Single Source of Truth:** Read **[`TRUTH.md`](TRUTH.md)** for our master project identity, core commands, and architectural blueprint.

## ๐Ÿ“Š Current Status

| Metric | Value |
| ------------------- | ---------------------------------------------------------------------- |
| **Version** | v6.0.0 ([Latest release](https://github.com/jonbeatz/MyStudioChannel/releases/latest); live at [mystudiochannel.com](https://mystudiochannel.com) until next deploy) |
| **Stack** | Next.js 15 (React 19) + Payload CMS 3.81.0 |
| **CMS Engine** | โœ… MSC PRO ENGINE Studio Mode โ€” Gold Sidebar + Dashboard |
| **Deployment** | โœ… Tiered FTPS (Hostinger/hPanel) via `PushItUP` |
| **Database** | โœ… Local SQLite (Production-hardened) |
| **Verified** | โœ… `npm run verify:next` (Build Gate + Integrity) |
| **Status** | ๐ŸŸข Production Ready |

---

## ๐Ÿš€ Why My Studio Channel?

Most templates give you a website. **MSC gives you a complete media broadcasting operating system.**

| Capability | My Studio Channel | Typical Boilerplate |
| ---------------------------------- | ----------------- | ------------------- |
| Network-Style Layouts | โœ… | โŒ |
| MSC PRO ENGINE (Custom CMS) | โœ… | โŒ |
| Cinema-Quality Bento Grids | โœ… | โŒ |
| Tiered FTPS Deploy Engine | โœ… | โŒ |
| Zero Platform Fees (Ownership) | โœ… | โŒ |
| Agent-Ready Documentation | โœ… | โŒ |
| Hardened Production Verify Scripts | โœ… | โŒ |
| 16:9 Cinematic Design System | โœ… | โŒ |

---

## ๐Ÿ–ผ๏ธ Screenshots

### Built for Creators Like You
![Built for Creators](.cursor/design-references/MSC-Pages/MSC-Pages-v2.jpg)
*Structured layouts for Podcasters, Content Creators, and Network Builders.*

### Custom Add-Ons & Recommendations
![View Demos](.cursor/design-references/MSC-Pages/MSC-Pages-v6.jpg)
*Integrated demo viewer with pro-grade video production website designs.*

### High Quality Showcase Templates
![Add-Ons](.cursor/design-references/MSC-Pages/MSC-Pages-v5.jpg)
*Complete platform guidance from domain setup to social media graphics packages.*

---

## ๐Ÿš€ Quick Start

```bash
git clone https://github.com/jonbeatz/MyStudioChannel.git
cd MyStudioChannel
npm install # Install dependencies
copy .env.example .env.local # Setup environment (Windows)
npm run dev:payload # Start dev server on :3000
```

**Open `http://localhost:3000`** โ€” The MSC portal.
**Admin `http://localhost:3000/admin`** โ€” MSC PRO ENGINE Studio Mode.

Verify the baseline gate:
```bash
npm run verify:next # clean ยท build ยท integrity check
```

> **Requirements:** Node 20.x+ ยท npm โ‰ฅ 10
> **Secrets:** Live keys belong in `.env.local` only โ€” never commit secrets.

> **Agent ritual:** Say `Begin project` in Cursor chat for full cold-start โ€” see START-HERE.md.

---

## ๐Ÿ—๏ธ Architecture

```
My Studio Channel
โ”œโ”€โ”€ MSC PRO ENGINE # Custom Payload CMS admin experience
โ”œโ”€โ”€ Frontend (port 3000) # Next.js 15 App Router (React 19)
โ”œโ”€โ”€ PushItUP Engine # Tiered FTPS deployment automation
โ”œโ”€โ”€ NovaMira Design # High-end studio UI components
โ””โ”€โ”€ Jedi Tooling # msc:* script system for ops
```

---

## ๐Ÿ›ก๏ธ Production-Hardening & Reliability Features

The `MSC-Website-v6` line continues comprehensive safety and developer experience features from v5:
- **Database Optimization Utility:** Optimize database files with `npm run db:optimize` (using `PRAGMA optimize` + `VACUUM`), automated to prevent bloat.
- **Git Pre-commit Hook (Husky):** Enforces lint checks automatically on every `git commit`, preventing bad syntax or build errors from entering git.
- **SSH Live Log Streaming:** Instantly tail remote host logs on your PC terminal via `npm run logs:live` (stderr) and `npm run logs:live:console`.
- **Version & Branch Tracking:** Automated version mapping, branch names, and commit hashes embedded inside backup notes.
- **Post-Backup Verification:** Self-testing backup checker that validates the structural completeness of local backups automatically.
- **Backup Retention Manager:** Simple retention utility via `npm run backup:clean` that retains only the 10 most recent backups and purges older folders.

## ๐Ÿ“ฆ Deployment Workflow

Optimized for **Hostinger (hPanel)** with **automated validation and recovery**:

- **Say "push it live"** in Cursor โ€” agent asks mode: **Quick DB** (`msc:push:db:live`) ยท **Full FTPS** ยท **MCP code-only** (verify DB after โ€” MCP/Git โ‰  DB deploy)
- **Tier 1 (Branding):** `npm run pushitup:admin-branding` (CSS + Graphics fast ship)
- **Tier 2 (App):** `npm run pushit:live` (Full build, `.next`, DB + media; auto **`msc:hostinger:sync-db`** after DB upload)
- **Tier 3 (Config):** `npm run pushitup:server-config` (Package/Server files contract)

---

## ๐Ÿ“š Documentation

| Document | Purpose |
| -------------------------------------------------- | ------------------------------------------------- |
| [START-HERE.md](./.cursor/docs/START-HERE.md) | Operator cold-start & source-of-truth order |
| [MASTER-COMMANDS.md](./.cursor/docs/MASTER-COMMANDS.md) | Master list of dev, deployment, and troubleshooting commands |
| [Agent-Runbook.md](./.cursor/docs/Agent-Runbook.md) | Standardized prompts for consistent workflow |
| [HOSTINGER-DEPLOY.md](./.cursor/docs/HOSTINGER-DEPLOY.md) | Production hosting playbook (Path A/B/C) & recovery |
| [DEPLOYMENT-TROUBLESHOOTING.md](./.cursor/docs/DEPLOYMENT-TROUBLESHOOTING.md) | Root-cause troubleshooting for 503/500/504 and DB deployment issues |
| [DEPLOYMENT-FIXES.md](./.cursor/docs/DEPLOYMENT-FIXES.md) | Hostinger deploy learnings & canonical dependency rule |
| [Jedi-List.md](./.cursor/docs/Jedi-List.md) | Command quick-reference for npm scripts |
| [CHANGELOG.md](./CHANGELOG.md) | Release history |
| [TOOL-CHEST.md](./.cursor/docs/TOOL-CHEST.md) | Master index of external APIs, services, and search proxies |
| [Restore-Points.md](./.cursor/docs/Restore-Points.md) | Milestone checkpoints & rollback instructions |

---

## ๐Ÿ‘ฅ Contributors

- **Jon Beatz** - Creator & Developer
- GitHub: [@jonbeatz](https://github.com/jonbeatz)
- Email: createmystudiochannel@gmail.com

---

## ๐Ÿ“„ License

MIT ยฉ My Studio Channel

---


ยท Powered by the MSC Media Engine