Frameworks
Eleventy on Stackap
Stackap builds an Eleventy site and serves its _site folder from nginx, but only when package.json has a build script, which Eleventy projects often lack.
How Stackap recognizes Eleventy
A project counts as an Eleventy site when it lists @11ty/eleventy as a dependency and has a script named build. Eleventy is commonly run directly from the command line, and many projects define only start or serve. Without a build script, detection never reaches the Eleventy case, and the project could instead be mistaken for a Node app if it has a start script that runs the development server.
What Stackap builds
The fix is one line: add "build": "eleventy" to the scripts. After that the generated image runs it and copies the _site folder, Eleventy's default output, into nginx. If you changed the output folder in your config, it must be one of the folders Stackap searches, or you can bring a Dockerfile.
Eleventy produces plain HTML files, so the server returns real 404 responses and there is no application code to run. This is the lightest kind of site Stackap hosts.
If your site uses a path prefix in its config, make sure it matches where the site is served, which for a domain of its own is the root.
What a Eleventy project needs
- A
buildscript inpackage.json. - Output in
_site, or in another folder from the searched list. - A lockfile.
- No path prefix unless the site really lives under one.
Verification status
The static path has a real Docker build in the platform tests. A plain-HTML repository with no build at all has been served live on the server.
Still to verify: an Eleventy build by us, or Eleventy plugins that fetch data over the network at build time.
Early-access scope
- No Eleventy site has been shipped on Stackap yet.
- No build script means no recognition, and the failure message will not mention Eleventy.
- Data fetched at build time is fetched during the Stackap build, so it needs the network and any secrets will be placeholders.
- No CDN.
Questions
My site has only a plain index.html. Is that the same?
index.html at the root and no start script is served as a plain static site with no build at all. See static sites.Why did my Eleventy site start a dev server?
start script that runs one and no build script, so it was treated as a Node app. Add the build script.Stackap is in early access. Tell us what you run and we will reply with a straight answer about whether it fits.
Ask for an invitationLast updated .