docs: add README

Engine repo had no README. Cover what NextDeploy is, the install
one-liner, the four-command quick start, supported targets, build
from source, and the repo layout.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: aynaash

README.md

@@ -0,0 +1,68 @@
+# NextDeploy
+
+Deploy Next.js apps to a VPS, AWS Lambda, or Cloudflare Workers from one
+config file and one command. Open source, self-hosted, no vendor lock-in.
+
+```bash
+curl -fsSL https://nextdeploy.org/install.sh | bash
+```
+
+Windows: download `install.bat` from <https://nextdeploy.org/install.bat>.
+
+## Quick start
+
+```bash
+nextdeploy init     # scaffold nextdeploy.yml in your Next.js repo
+nextdeploy plan     # show what will happen, change nothing
+nextdeploy ship     # build + push + deploy to your target
+nextdeploy logs -f  # tail production logs
+```
+
+`nextdeploy.yml` holds everything — target type, domain, server, secrets
+provider. See `sample.nextdeploy.yml` in this repo for the full schema.
+
+## Targets
+
+| Target          | Status | What it gives you                                  |
+| --------------- | ------ | -------------------------------------------------- |
+| **VPS**         | stable | Docker + Caddy + the `nextdeployd` daemon over SSH |
+| **AWS**         | stable | Lambda + S3 + CloudFront, full SSR/ISR/image opt   |
+| **Cloudflare**  | beta   | Workers + R2 + KV via the `nextcompile` adapter    |
+
+## Build from source
+
+```bash
+git clone https://github.com/aynaash/NextDeploy
+cd NextDeploy
+go build -o nextdeploy ./cli
+```
+
+Requires Go 1.25+. The release binaries on GitHub are built with
+GoReleaser; see `.goreleaser.yml`.
+
+## Repository layout
+
+```
+cli/                       Cobra CLI entry, all top-level commands
+daemon/                    nextdeployd — the agent that runs on each VPS
+shared/nextcompile/        Build-time compiler + JS runtime for CF Workers
+shared/nextcore/           Next.js project introspection (config, routes, deps)
+cli/internal/serverless/   AWS adapter (Lambda, S3, CloudFront, ACM)
+sample.nextdeploy.yml      Annotated reference config
+```
+
+## Documentation
+
+- Full docs: <https://nextdeploy.org/docs>
+- Sample config: [`sample.nextdeploy.yml`](./sample.nextdeploy.yml)
+- Each command also has `nextdeploy <cmd> explain` for inline help
+
+## Contributing
+
+Issues and PRs welcome. Run `go test ./...` before pushing — the release
+pipeline is gated on a green test run. For larger changes, open an issue
+first so we can align on direction.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).