FAQ
General
What is Revela?
Revela is a static site generator built specifically for photographers. It takes your photos and generates a fast, beautiful portfolio website with no database and no server, just HTML and optimized images.
Do I need programming experience?
No. Revela runs as a simple text menu that you control with the arrow keys and Enter, and a setup wizard guides you through creating your first site. You'll need to be comfortable with basic file management (creating folders, copying files), but no coding is required. Your First Site walks you through it in six steps.
Is my website online as soon as Revela has built it?
No. Revela builds the website on your computer, in the output folder; it isn't an online service and needs no account. To put the site online, you upload that folder to a web host of your choice. The Deployment guide shows free options such as GitHub Pages, Netlify and Cloudflare Pages.
Does Revela change my original photos?
No. Revela only reads the photos in your source folder and writes separate web versions into output. Your originals are never resized, re-saved or moved.
What platforms does Revela run on?
Windows (x64 and ARM64), macOS (Apple Silicon), and Linux (x64 and ARM64). Every download is a ready-to-run program, so there's no runtime installation needed.
Does Revela require Node.js, Ruby, or Python?
No. The Standalone and Full downloads are self-contained programs with nothing else to install. Only the optional .NET global tool needs the .NET 10 SDK; its .nupkg files are attached to each GitHub Release (Revela is not on NuGet.org yet).
Images
Which files can I put in?
JPEG, PNG, WebP and GIF. RAW files are not read, so export JPEGs from Capture One, Lightroom or your photo editor first, ideally at full resolution in Display P3 or Adobe RGB. See exporting from your photo editor for a recommended preset.
What image formats does Revela generate?
Revela generates AVIF, WebP, and JPEG: modern formats for maximum compression, with fallbacks for older browsers. Each image is generated in multiple sizes for responsive loading.
How many sizes are generated per image?
The theme decides. The built-in Lumina theme defines 160, 320, 480, 640, 720, 960, 1280, 1440, 1920, and 2560 pixels. Revela generates every theme size that is smaller than your original, plus one version at the original size for full-screen viewing. Nothing is ever upscaled.
How fast is image processing?
Revela uses NetVips (libvips) and processes several photos in parallel. Builds are incremental: only new or changed photos are processed again. The first build of a large collection still takes a while, because every photo is turned into several sizes in AVIF, WebP and JPEG. As an example, about 1,200 full-resolution photos took around half an hour on a 6-core server; later builds took seconds to minutes, depending on how much changed.
What EXIF data is preserved?
By default, EXIF data is stripped from generated images (for privacy and file size). The original EXIF data is read during scanning for statistics, sorting, and filtering, but it isn't embedded in the output.
Themes
Can I customize the built-in theme?
Yes, in three levels:
- In the menu, without code: your site's title, description, author, copyright line and language (config → site), the theme and how photos open, on their own page or in a lightbox (config → theme), and image formats and quality (config → image).
- Colors, spacing and fonts: a few CSS custom properties in one file. Extract
Assets/main.csswith theme → extract and edit the values; no template changes needed. - Layout and markup: place files in your project's
themes/Lumina/folder to override any template, partial or asset. Only the files you change need to live in your project, and everything else comes from the built-in theme. Theme Authoring covers the templates.
See Theme Customization for details.
Can I create my own theme from scratch?
Yes. There are three approaches, depending on how far you want to go:
Customize an existing theme. Place override files in your project's
themes/Lumina/folder. Only the files you change are needed, and everything else comes from the base theme. This is how revela.website is built. See Theme Customization.Create a theme from scratch. Create
themes/MyTheme/in your project folder with at least these files:theme.json: the theme manifest. It is required; without it Revela ignores the folder. The smallest version is{ "name": "MyTheme", "photoViewers": ["none"], "defaultPhotoViewer": "none" }.Layout.revela: the page layout (a Scriban template).Partials/ContentImage.revela: how images inside Markdown text are rendered.Configuration/images.json: the image sizes to generate, for example{ "sizes": [640, 1280, 1920] }.
Then select the theme in
project.json:{ "theme": { "name": "MyTheme" } }No package is needed, since Revela loads local themes first.
revela checkhelps you spot missing pieces.Share it as a package. Package your theme as a
.nupkgwithPackageType=RevelaTheme. Others add the folder or feed that hosts it (revela config feed add) and install it withrevela theme install.
Hosting & Deployment
Where can I host my Revela site?
Anywhere that serves static files: GitHub Pages, Netlify, Cloudflare Pages, Vercel, Amazon S3, or any traditional web hosting. Revela generates plain HTML, so there's no server-side processing needed.
How large is a typical generated site?
It depends on your images and quality settings. A portfolio with 50 photos at default settings produces roughly 150-300 MB of optimized images plus a few hundred KB of HTML/CSS. With Brotli pre-compression (Compress plugin), the HTML/CSS portion shrinks by about 80%.
Can I use a CDN for images?
Yes. Set project.assetsBasePath in project.json to your CDN URL. Revela will generate HTML that references images from the CDN instead of relative paths.
Plugins
How do I install plugins?
In the Standalone edition, all official plugins are already built in. There is nothing to install.
In the Full edition, install them from the bundled packages/ folder:
revela plugin install Statistics
revela plugin install Serve
Plugins are distributed as NuGet packages (.nupkg) attached to each GitHub Release, not on NuGet.org. If you use the .NET tool, download them into a folder and register it once with revela config feed add releases /path/to/folder.
What plugins are available?
- Compress: pre-compress output with Gzip and Brotli
- Statistics: generate EXIF statistics pages (cameras, lenses, apertures)
- Serve: local static preview server (no live reload; regenerate and refresh)
- Calendar: availability calendar (booked/free days) from iCal
.icsfiles - Source OneDrive: sync photos from OneDrive shared folders
- Source Calendar: download iCal feeds (e.g. booking exports) into your source folder
Can I write my own plugin?
Yes. Reference the Spectara.Revela.Sdk package (download Spectara.Revela.Sdk.<version>.nupkg from GitHub Releases; it is not on NuGet.org yet) and implement the IPlugin interface. See the Plugin Development Guide and the developer orientation.