Initial setup wizard contents

scwx-qt/source/scwx/qt/ui/setup/finish_page.cpp

@@ -1,5 +1,8 @@
 #include <scwx/qt/ui/setup/finish_page.hpp>
 
+#include <QLabel>
+#include <QVBoxLayout>
+
 namespace scwx
 {
 namespace qt
@@ -14,11 +17,27 @@ class FinishPage::Impl
 public:
    explicit Impl() = default;
    ~Impl()         = default;
+
+   QVBoxLayout* layout_ {nullptr};
+   QLabel*      finishLabel_ {nullptr};
 };
 
 FinishPage::FinishPage(QWidget* parent) :
     QWizardPage(parent), p {std::make_shared<Impl>()}
 {
+   setTitle(tr("Setup Complete"));
+   setSubTitle(tr("Supercell Wx setup is complete!"));
+
+   p->finishLabel_ =
+      new QLabel(tr("Supercell Wx setup is now complete and ready for use. "
+                    "Additional settings may be configured after startup. For "
+                    "further information, please see the User Manual from the "
+                    "Help menu, or join the Discord server for help."));
+   p->finishLabel_->setWordWrap(true);
+
+   p->layout_ = new QVBoxLayout(this);
+   p->layout_->addWidget(p->finishLabel_);
+   setLayout(p->layout_);
 }
 
 FinishPage::~FinishPage() = default;

scwx-qt/source/scwx/qt/ui/setup/map_page.cpp

@@ -19,6 +19,8 @@ public:
 MapPage::MapPage(QWidget* parent) :
     QWizardPage(parent), p {std::make_shared<Impl>()}
 {
+   setTitle(tr("Map Configuration"));
+   setSubTitle(tr("Configure the Supercell Wx map provider and basic layout."));
 }
 
 MapPage::~MapPage() = default;

scwx-qt/source/scwx/qt/ui/setup/setup_wizard.cpp

@@ -1,4 +1,11 @@
 #include <scwx/qt/ui/setup/setup_wizard.hpp>
+#include <scwx/qt/ui/setup/finish_page.hpp>
+#include <scwx/qt/ui/setup/map_page.hpp>
+#include <scwx/qt/ui/setup/welcome_page.hpp>
+#include <scwx/qt/settings/general_settings.hpp>
+
+#include <QDesktopServices>
+#include <QUrl>
 
 namespace scwx
 {
@@ -19,10 +26,45 @@ public:
 SetupWizard::SetupWizard(QWidget* parent) :
     QWizard(parent), p {std::make_shared<Impl>()}
 {
+   setWindowTitle(tr("Supercell Wx Setup"));
+   setPixmap(QWizard::LogoPixmap, QPixmap(":/res/icons/scwx-64.png"));
+
+   setOption(QWizard::WizardOption::IndependentPages);
+   setOption(QWizard::WizardOption::NoBackButtonOnStartPage);
+   setOption(QWizard::WizardOption::NoCancelButton);
+   setOption(QWizard::WizardOption::HaveHelpButton);
+
+   setPage(static_cast<int>(Page::Welcome), new WelcomePage(this));
+   setPage(static_cast<int>(Page::Map), new MapPage(this));
+   setPage(static_cast<int>(Page::Finish), new FinishPage(this));
+
+#if !defined(Q_OS_MAC)
+   setWizardStyle(QWizard::WizardStyle::ModernStyle);
+#endif
+
+   connect(this,
+           &QWizard::helpRequested,
+           this,
+           []() {
+              QDesktopServices::openUrl(
+                 QUrl {"https://supercell-wx.readthedocs.io/"});
+           });
 }
 
 SetupWizard::~SetupWizard() = default;
 
+bool SetupWizard::IsSetupRequired()
+{
+   auto& generalSettings = settings::GeneralSettings::Instance();
+
+   std::string mapboxApiKey   = generalSettings.mapbox_api_key().GetValue();
+   std::string maptilerApiKey = generalSettings.maptiler_api_key().GetValue();
+
+   // Setup is required if either API key is empty, or contains a single
+   // character ("?")
+   return (mapboxApiKey.size() <= 1 && maptilerApiKey.size() <= 1);
+}
+
 } // namespace setup
 } // namespace ui
 } // namespace qt

scwx-qt/source/scwx/qt/ui/setup/setup_wizard.hpp

@@ -14,9 +14,18 @@ namespace setup
 class SetupWizard : public QWizard
 {
 public:
+   enum class Page : int
+   {
+      Welcome = 0,
+      Map,
+      Finish
+   };
+
    explicit SetupWizard(QWidget* parent = nullptr);
    ~SetupWizard();
 
+   static bool IsSetupRequired();
+
 private:
    class Impl;
    std::shared_ptr<Impl> p;

scwx-qt/source/scwx/qt/ui/setup/welcome_page.cpp

@@ -1,5 +1,8 @@
 #include <scwx/qt/ui/setup/welcome_page.hpp>
 
+#include <QLabel>
+#include <QVBoxLayout>
+
 namespace scwx
 {
 namespace qt
@@ -14,11 +17,26 @@ class WelcomePage::Impl
 public:
    explicit Impl() = default;
    ~Impl()         = default;
+
+   QVBoxLayout* layout_ {nullptr};
+   QLabel*      welcomeLabel_ {nullptr};
 };
 
 WelcomePage::WelcomePage(QWidget* parent) :
     QWizardPage(parent), p {std::make_shared<Impl>()}
 {
+   setTitle(tr("Introduction"));
+   setSubTitle(tr("Welcome to Supercell Wx!"));
+
+   p->welcomeLabel_ =
+      new QLabel(tr("Welcome to Supercell Wx. This wizard will guide you "
+                    "through configuring Supercell Wx for initial use, as well "
+                    "as introduce you to any new features."));
+   p->welcomeLabel_->setWordWrap(true);
+
+   p->layout_ = new QVBoxLayout(this);
+   p->layout_->addWidget(p->welcomeLabel_);
+   setLayout(p->layout_);
 }
 
 WelcomePage::~WelcomePage() = default;