Play a finished motion-graphics ad in sync with the rough drafts it grew from, and export the breakdown as MP4.
HTML after-effects-alternativeai-videoanimationbreakdowncreative-codingffmpeggood-first-issuegsaphelp-wantedhtml-videohyperframesjavascriptkinetic-typographymotion-designmotion-graphicsnodejsopen-sourcevideovideo-editingwebcodecs
chore: add issue forms, PR template, CONTRIBUTING, and funding link
Kaihan Wasely84fda94e24f4
diff --git a/.github/FUNDING.yml b/.github/FUNDING.ymlnew file mode 100644index 0000000..10e4c0c--- /dev/null+++ b/.github/FUNDING.yml@@ -0,0 +1 @@+buy_me_a_coffee: blixdiff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.ymlnew file mode 100644index 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.ymlnew file mode 100644index 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.ymlnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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).