DOCUMENTATION

Build, deploy, and run projects on Nerddi Cloud.

The hosting guides now cover files, immutable releases, production serving, routing, custom domains, analytics, and the scoped SkyMind Partner API.

01Getting startedCreate a project, upload files and make the first release.02Files & uploadsFolder, ZIP and File Manager workflow.03DeploymentsPreview, publish and rollback immutable versions.04Routing & headersClean URLs, SPA fallback, redirects, headers and caching.05Site originsPath compatibility and isolated platform subdomains.06SkyMind publishingConnect, import, preview and publish through the scoped Partner API.

GETTING STARTED

Create → upload → deploy → preview → publish.

Create a project in the Cloud console, open its File Manager, and add a root index.html. Build a deployment from the draft workspace. Nerddi Host independently validates the immutable artifact before it can reach READY. Preview the exact verified version, then publish it atomically.

FILES

Static and client-side projects in v1.

Folder uploads, multi-file uploads, ZIP extraction, file creation, rename/move/copy, Trash/restore and browser editing are supported. Server-executable PHP, shell, Python, CGI and server-control files are intentionally blocked in the shared hosting tier.

DEPLOYMENTS

Production never overwrites a previous release.

Each release receives its own immutable version. Publishing switches the site's production pointer; rollback points production back to an earlier verified release. Preview links are short-lived bearer URLs that remain non-cacheable and non-indexable.

NERDDI.JSON

Control routing without server configuration files.

Add a root nerddi.json to configure clean URLs, SPA fallback, redirects, safe custom response headers and cache policies. Host validates the configuration before a deployment becomes READY. Dangerous server-owned headers and cookie injection are rejected.

{
  "clean_urls": true,
  "spa": true,
  "redirects": [
    { "from": "/old/*", "to": "/new/*", "status": 308 }
  ],
  "cache": {
    "assets": "public, max-age=3600"
  }
}

ORIGIN ISOLATION

Isolated origins are the production target.

The compatibility address is host.nerddi.com/site. Active documents on that shared origin are browser-sandboxed. Once wildcard DNS and TLS are enabled, the preferred application address becomes site.host.nerddi.com, giving each project its own browser origin for storage, cookies, service workers and PWA behavior.

SKYMIND

Build in SkyMind. Publish through Nerddi Cloud.

SkyMind connects to a specific Cloud workspace with a revocable scoped token. The SkyMind server must also authenticate every API request with its own HMAC credential, so the integration never needs the user's Nerddi ID OAuth token or the Cloud→Host deployment secret. Linked projects can be updated repeatedly without creating duplicate sites.

See docs/skymind-partner-api.md in the deployment package for the server-to-server contract.