Skip to content

Play a finished motion-graphics ad in sync with the rough drafts it grew from, and export the breakdown as MP4.

chore: add issue forms, PR template, CONTRIBUTING, and funding link

Kaihan Wasely84fda94e24f4
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
new file mode 100644
index 0000000..10e4c0c
--- /dev/null
+++ b/.github/FUNDING.yml
@@ -0,0 +1 @@
+buy_me_a_coffee: blix
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100644
index 0000000..83670f1
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,62 @@
+name: 🐞 Bug report
+description: Something in Null Motion is broken or behaves unexpectedly.
+labels: ["bug"]
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Thanks for reporting! Quick checks first:
+ - Export needs **Chrome or Edge** (WebCodecs).
+ - The server needs **Node.js 22+**.
+ - See the [FAQ and troubleshooting](https://github.com/blixvip/NullMotion#faq-and-troubleshooting) section.
+ For questions rather than bugs, the [Discord](https://discord.gg/zEB4VjmfSb) is faster.
+ - type: dropdown
+ id: area
+ attributes:
+ label: Area
+ options:
+ - Preview playback / drafts
+ - MP4 export (Download → Whole preview)
+ - Import script (import-motionclone.py)
+ - Section planning / showcase scripts
+ - Launch editor (/editor)
+ - Server / npm start
+ - Other
+ validations:
+ required: true
+ - type: textarea
+ id: what-happened
+ attributes:
+ label: What happened?
+ description: What did you do, what did you expect, and what happened instead?
+ placeholder: "1. npm start\n2. Opened Infinite and clicked Download → Whole preview\n3. The button said 'Export failed'"
+ validations:
+ required: true
+ - type: textarea
+ id: logs
+ attributes:
+ label: Logs or console output
+ description: Terminal output and/or the browser console (F12). Pasted text is rendered as code.
+ render: shell
+ - type: input
+ id: os
+ attributes:
+ label: Operating system
+ placeholder: Windows 11, macOS 15, Ubuntu 24.04…
+ validations:
+ required: true
+ - type: input
+ id: browser
+ attributes:
+ label: Browser and version
+ placeholder: Chrome 141
+ - type: input
+ id: node
+ attributes:
+ label: Node.js version (`node -v`)
+ placeholder: v22.12.0
+ - type: input
+ id: commit
+ attributes:
+ label: Commit or release
+ description: "`git rev-parse --short HEAD`, or the release tag you downloaded."
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..e0467e1
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,11 @@
+blank_issues_enabled: true
+contact_links:
+ - name: 💬 Questions and help (Discord)
+ url: https://discord.gg/zEB4VjmfSb
+ about: Setup questions, "how do I…", and general help are fastest in the Insider AI Discord.
+ - name: 🎬 Show what you made (Discord)
+ url: https://discord.gg/zEB4VjmfSb
+ about: Share your exported breakdowns and drafts with the community.
+ - name: Null Studio (hosted product)
+ url: https://www.nullmotion.com/
+ about: Pause cuts, captions, and YouTube/Twitch/Kick clips are Null Studio, a separate product. This repo is the local launch-film preview.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
new file mode 100644
index 0000000..265da67
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,34 @@
+name: ✨ Feature request
+description: Suggest an idea or improvement for Null Motion.
+labels: ["enhancement"]
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Ideas are welcome! Note that pause cuts, captions, and YouTube/Twitch/Kick clips belong to
+ [Null Studio](https://www.nullmotion.com/), a separate hosted product, not this repo.
+ Want to talk an idea through first? Drop it in the [Discord](https://discord.gg/zEB4VjmfSb).
+ - type: textarea
+ id: problem
+ attributes:
+ label: What problem would this solve?
+ placeholder: When I export a breakdown, I want to…
+ validations:
+ required: true
+ - type: textarea
+ id: idea
+ attributes:
+ label: Your idea
+ description: What should Null Motion do? Sketches, screenshots, or example ads help a lot.
+ validations:
+ required: true
+ - type: textarea
+ id: alternatives
+ attributes:
+ label: Alternatives or workarounds you've tried
+ - type: checkboxes
+ id: help
+ attributes:
+ label: Contributing
+ options:
+ - label: I'd be willing to open a pull request for this.
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
new file mode 100644
index 0000000..04a72d4
--- /dev/null
+++ b/.github/pull_request_template.md
@@ -0,0 +1,18 @@
+## What does this change?
+
+<!-- A short description. Link the issue it fixes, e.g. "Fixes #12". -->
+
+## How did you test it?
+
+- [ ] `npm test` passes
+- [ ] `npm run check` passes
+- [ ] UI changes checked in a real browser at narrow and wide widths (screenshot or GIF below)
+- [ ] Export still works in Chrome or Edge (if the preview or exporter changed)
+
+## Checklist
+
+- [ ] No new runtime dependencies, keys, or calls to other origins
+- [ ] No new reference footage added to `showcase/` or Git
+- [ ] README updated if behavior or setup changed
+
+<!-- Questions? Ask in the Discord: https://discord.gg/zEB4VjmfSb -->
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..675c946
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,39 @@
+# Contributing to Null Motion
+
+Thanks for helping! Questions and ideas are welcome in the **[Discord](https://discord.gg/zEB4VjmfSb)**, and bugs go in [GitHub issues](https://github.com/blixvip/NullMotion/issues/new/choose).
+
+## Setup
+
+You need **Node.js 22+**. There are no dependencies, so there's no `npm install` step.
+
+```sh
+git clone https://github.com/<you>/NullMotion.git
+cd NullMotion
+npm run dev # http://127.0.0.1:4343, restarts on change
+```
+
+Use **Chrome or Edge** to test MP4 export. FFmpeg/ffprobe and Python 3 are only needed for the import, section, and showcase scripts (see the README).
+
+## Before you open a pull request
+
+```sh
+npm test # node --test
+npm run check # syntax-checks every UI file and blocks hardcoded local companion URLs
+```
+
+- Keep changes small and focused. One fix or feature per pull request.
+- Check UI changes in a real browser at narrow and wide widths, and add a screenshot or GIF.
+- Don't add runtime dependencies, API keys, or calls to other origins. The browser only talks to this project's own server.
+- Don't commit reference footage. Imported media lives in the ignored `.local-media/` and `public/references/` folders, and `showcase/` holds only the three published references.
+- Keep UI status honest: generation, rendering, and Premiere are not connected in this repo.
+- Keep the bundled third-party notices in `THIRD_PARTY_NOTICES.md`.
+
+## Where things live
+
+- `public/demo.*`: the preview page and MP4 exporter (the homepage)
+- `public/drafts.mjs`: the HyperFrames draft engine. New beat kinds go here.
+- `server.js`, `media.js`: static server, byte-range streaming, audio extraction
+- `scripts/`: import, section planning, showcase, waveforms, checks
+- `test/`: Node test runner tests
+
+Made something with it? Show it off in the [Discord](https://discord.gg/zEB4VjmfSb).