assets.hpp

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Povl Filip Sonne-Frederiksen
//
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
// Static-asset serving for `rux gui`.
//
// The frontend bundle is a *data asset installed next to the binary*, never
// embedded in it (issue #265): Phase 2 builds it with Nix into
// `share/reusex/gui/` and the server picks it up from there. Until that bundle
// exists, a built-in placeholder page stands in so the server is usable and
// self-describing on day one.
 
#include <filesystem>
#include <string>
#include <string_view>
 
namespace rux::gui {

std::filesystem::path
resolve_asset_dir(const std::filesystem::path &override_dir);

std::filesystem::path executable_dir();

std::string percent_decode(std::string_view text);

std::filesystem::path resolve_asset(const std::filesystem::path &root,
                                    std::string_view url_path);

bool looks_like_spa_route(std::string_view url_path);

std::string mime_type_for(const std::filesystem::path &path);

std::string placeholder_page(std::string_view project_name);
 
} // namespace rux::gui