Skip to main content

Deploy

The API is a Deno server at src/main.ts. The documentation site is a Docusaurus app in docs-site/.

Deploy the API to Deno Deploy​

Use the Deno Deploy console:

  1. Push the repository to GitHub.
  2. Open the Deno Deploy console.
  3. Create a new app in your organization.
  4. Select the GitHub repository or choose a local-source deployment flow.
  5. Set the entrypoint to src/main.ts.
  6. Leave build commands empty.
  7. Deploy to production.

Or create and deploy from the current directory with the current Deno Deploy CLI:

deno deploy create --org=<your-org-slug> --app=<your-app> --source=local --region=global --runtime-mode=dynamic --entrypoint=src/main.ts .
deno deploy --org=<your-org-slug> --app=<your-app> --prod .

Deploy the Documentation​

Build the Docusaurus site:

cd docs-site
npm run build

Set SITE_URL when you want canonical and Open Graph URLs to use your production domain:

SITE_URL=https://your-production-domain npm run build

The static output is written to:

docs-site/build

You can deploy that folder to any static hosting provider.

Same-Origin Playground​

The playground fills its API base URL from the current page origin. For the best experience, serve the documentation and API from the same domain, or put a reverse proxy in front of them:

/docs -> Docusaurus site
/resolve -> Deno API
/download -> Deno API

If the docs and API are hosted separately, users can still edit the API base URL in the playground.

Verify After Deployment​

Current API baseDetecting the current page origin...
/health
/resolve?url=https://v.douyin.com/2LjM6XJNEXQ/