Initial repo setup

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,34 @@
+---
+name: Bug Report
+about: Report a bug to help us improve
+title: ""
+labels: bug
+assignees: ""
+---
+
+## Describe the bug
+
+A clear description of what the bug is.
+
+## To reproduce
+
+Steps to reproduce the behavior:
+
+1. ...
+2. ...
+3. ...
+
+## Expected behavior
+
+What you expected to happen.
+
+## Environment
+
+- OS: [e.g., macOS 15, Ubuntu 24.04, Windows 11]
+- Node.js version: [e.g., 22.x]
+- FFmpeg version: [e.g., 7.x]
+- Hyperframes version: [e.g., 0.1.0]
+
+## Additional context
+
+Any other context, screenshots, or error logs.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature Request
+about: Suggest an idea for Hyperframes
+title: ""
+labels: enhancement
+assignees: ""
+---
+
+## Problem
+
+What problem does this solve? What's the use case?
+
+## Proposed solution
+
+How should it work?
+
+## Alternatives considered
+
+Any alternative approaches you've thought about.
+
+## Additional context
+
+Any other context, mockups, or examples.

.github/pull_request_template.md

@@ -0,0 +1,19 @@
+## What
+
+Brief description of the change.
+
+## Why
+
+Why is this change needed?
+
+## How
+
+How was this implemented? Any notable design decisions?
+
+## Test plan
+
+How was this tested?
+
+- [ ] Unit tests added/updated
+- [ ] Manual testing performed
+- [ ] Documentation updated (if applicable)

.gitignore

@@ -0,0 +1,39 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+*.tsbuildinfo
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Test
+coverage/
+.debug/
+
+# Rendered output (not test fixtures — those use git LFS)
+output/
+
+# npm pack artifacts
+*.tgz
+
+# Logs
+*.log
+npm-debug.log*
+
+# Temporary
+tmp/
+.tmp/

CODE_OF_CONDUCT.md

@@ -0,0 +1,40 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+- The use of sexualized language or imagery, and sexual attention or advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project maintainers at **oss@heygen.com**. All complaints will
+be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/),
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html).

CONTRIBUTING.md

@@ -0,0 +1,26 @@
+# Contributing to Hyperframes
+
+Thanks for your interest in contributing to Hyperframes! This guide will help you get started.
+
+## Getting Started
+
+1. Fork the repository
+2. Clone your fork: `git clone https://github.com/YOUR_USERNAME/hyperframes.git`
+3. Install dependencies: `pnpm install`
+4. Create a branch: `git checkout -b my-feature`
+
+<!-- TODO: Fill in development setup details once packages are ported -->
+
+## Reporting Issues
+
+- Use [GitHub Issues](https://github.com/heygen-com/hyperframes/issues) for bug reports and feature requests
+- Search existing issues before creating a new one
+- Include reproduction steps for bugs
+
+## Code of Conduct
+
+This project follows the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](LICENSE).

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HeyGen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,49 @@
+# Hyperframes
+
+**Write HTML. Render video. Built for agents.**
+
+Hyperframes is an open-source video rendering framework that lets you create, preview, and render HTML-based video compositions — with first-class support for AI agents via MCP.
+
+## Why Hyperframes?
+
+- **HTML-native** — AI agents already speak HTML. No React required.
+- **Frame Adapter pattern** — bring your own animation runtime (GSAP, Lottie, CSS, Three.js).
+- **Deterministic rendering** — same input = identical output. Built for automated pipelines.
+- **AI-first design** — not a bolted-on afterthought.
+
+## Quick Start
+
+```bash
+npx create-hyperframe my-video
+cd my-video
+npx hyperframes dev      # preview in browser
+npx hyperframes render   # render to MP4
+```
+
+## How It Works
+
+Define your video as HTML with data attributes:
+
+```html
+<div id="stage" data-composition-id="my-video"
+     data-start="0" data-width="1920" data-height="1080">
+  <video id="clip-1" data-start="0" data-duration="5"
+         data-track="0" src="intro.mp4" muted playsinline></video>
+  <img id="overlay" data-start="2" data-duration="3"
+       data-track="1" src="logo.png" />
+  <audio id="bg-music" data-start="0" data-duration="9"
+         data-track="2" data-volume="0.5" src="music.wav"></audio>
+</div>
+```
+
+Preview instantly in the browser. Render to MP4 locally. Let AI agents compose videos using tools they already understand.
+
+<!-- TODO: Add packages table, AI agent integration section, comparison table, requirements, and docs link once packages are ported -->
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to contribute.
+
+## License
+
+[MIT](LICENSE)

SECURITY.md

@@ -0,0 +1,26 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in Hyperframes, please report it responsibly.
+
+**Do not open a public GitHub issue for security vulnerabilities.**
+
+Instead, email **security@heygen.com** with:
+
+- A description of the vulnerability
+- Steps to reproduce
+- Potential impact
+- Suggested fix (if any)
+
+We will acknowledge receipt within 48 hours and aim to provide a fix or mitigation plan within 7 days.
+
+## Supported Versions
+
+| Version | Supported |
+|---------|-----------|
+| 0.x     | Yes       |
+
+## Scope
+
+This policy applies to all packages in the `@hyperframes/*` npm scope and the code in this repository.

pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - "packages/*"