feat(cli): add game project template

Author: GaspardKirira

include/vix/cli/commands/new/NewGenerator.hpp

@@ -66,12 +66,18 @@ namespace vix::commands::new_cmd::generator
       const std::string &projName,
       std::string &err);
 
+  /// Generates all files for a Vix Game project under projectDir.
+  bool generate_game_project(
+      const fs::path &projectDir,
+      const std::string &projName,
+      std::string &err);
+
   // ------------------------------------------------------------------
   // Post-generation output
   // ------------------------------------------------------------------
 
   void print_next_steps_app(const fs::path &projectDir, const std::string &projName);
   void print_next_steps_vue(const fs::path &projectDir, const std::string &projName);
   void print_next_steps_lib(const fs::path &projectDir, const std::string &projName);
-
+  void print_next_steps_game(const fs::path &projectDir, const std::string &projName);
 } // namespace vix::commands::new_cmd::generator

include/vix/cli/commands/new/NewOutput.hpp

@@ -43,6 +43,11 @@ namespace vix::commands::new_cmd::output
       const std::filesystem::path &projectDir,
       const std::string &projName);
 
+  /// Full creation summary for a Game project.
+  void print_creation_game(
+      const std::filesystem::path &projectDir,
+      const std::string &projName);
+
 } // namespace vix::commands::new_cmd::output
 
 #endif

include/vix/cli/commands/new/NewTemplates.hpp

@@ -171,6 +171,16 @@ WAF_MODE=basic
   std::string make_vue_main_js();
   std::string make_vue_app_vue();
 
+  // ------------------------------------------------------------------
+  // Game generators
+  // ------------------------------------------------------------------
+
+  std::string make_game_main_cpp(const std::string &projectName);
+  std::string make_game_package_json(const std::string &projectName);
+  std::string make_readme_game(const std::string &projectName);
+  std::string make_project_manifest_game(const std::string &projectName);
+  std::string make_vix_json_game(const std::string &projectName);
+
   // ------------------------------------------------------------------
   // CMakeLists.txt generators
   // ------------------------------------------------------------------

include/vix/cli/commands/new/NewTypes.hpp

@@ -18,7 +18,8 @@ namespace vix::commands::new_cmd
   {
     App,
     Lib,
-    Vue
+    Vue,
+    Game
   };
 
   struct FeaturesSelection

src/commands/NewCommand.cpp

@@ -99,7 +99,7 @@ namespace vix::commands::NewCommand
     if (argsIn.empty())
     {
       error("Missing project name.");
-      hint("Usage: vix new <name|path> [-d|--dir <base_dir>] [--app|--lib] [--force]");
+      hint("Usage: vix new <name|path> [-d|--dir <base_dir>] [--app|--lib|--game] [--force]");
       return 1;
     }
 
@@ -112,47 +112,63 @@ namespace vix::commands::NewCommand
 
     const bool wantsLib = has_any(args, {"--lib", "--library", "--type=lib", "--type=library"});
     const bool wantsApp = has_any(args, {"--app", "--application", "--type=app", "--type=application"});
+    const bool wantsGame = has_any(args, {"--game", "--type=game"});
 
     for (const auto &f : {"--lib", "--library", "--type=lib", "--type=library",
-                          "--app", "--application", "--type=app", "--type=application"})
+                          "--app", "--application", "--type=app", "--type=application",
+                          "--game", "--type=game"})
       consume_flag(args, f);
 
     if (args.empty())
     {
       error("Missing project name.");
-      hint("Usage: vix new <name|path> [--template vue] [--app|--lib] [--force]");
+      hint("Usage: vix new <name|path> [--template vue|game] [--app|--lib|--game] [--force]");
       return 1;
     }
 
-    if (!args[0].empty() && args[0][0] == '-' && !gen::is_dot_path(args[0]))
+    if ((wantsLib && wantsApp) || (wantsLib && wantsGame) || (wantsApp && wantsGame))
     {
-      error("Missing project name.");
-      hint("Options must come after a project name or be followed by one.");
-      step("vix new my-app --template vue");
+      error("Conflicting options: choose only one project type.");
       return 1;
     }
 
-    if (wantsLib && wantsApp)
+    if (!args[0].empty() && args[0][0] == '-' && !gen::is_dot_path(args[0]))
     {
-      error("Conflicting options: choose either --app or --lib.");
+      error("Missing project name.");
+      hint("Options must come after a project name or be followed by one.");
+      step("vix new my-app --template vue");
       return 1;
     }
 
     if (templateOpt.has_value())
     {
       const std::string tpl = *templateOpt;
 
-      if (tpl != "vue")
+      if (tpl != "vue" && tpl != "game")
       {
         error("Unknown template: " + tpl);
-        hint("Supported templates: vue");
+        hint("Supported templates: vue, game");
         return 1;
       }
 
       if (wantsLib)
       {
-        error("Conflicting options: --template vue cannot be used with --lib.");
-        hint("Vue templates generate applications.");
+        error("Conflicting options: --template cannot be used with --lib.");
+        hint("Templates currently supported: vue, game.");
+        return 1;
+      }
+
+      if (wantsApp && *templateOpt == "game")
+      {
+        error("Conflicting options: --template game cannot be used with --app.");
+        hint("Use --game or --template game.");
+        return 1;
+      }
+
+      if (wantsGame && *templateOpt == "vue")
+      {
+        error("Conflicting options: --template vue cannot be used with --game.");
+        hint("Use --app, --template vue, or --template game.");
         return 1;
       }
     }
@@ -277,10 +293,18 @@ namespace vix::commands::NewCommand
       // ------------------------------------------------------------------
       TemplateKind kind = TemplateKind::App;
 
-      if (templateOpt.has_value() && *templateOpt == "vue")
+      if (templateOpt.has_value() && *templateOpt == "game")
+      {
+        kind = TemplateKind::Game;
+      }
+      else if (templateOpt.has_value() && *templateOpt == "vue")
       {
         kind = TemplateKind::Vue;
       }
+      else if (wantsGame)
+      {
+        kind = TemplateKind::Game;
+      }
       else if (wantsLib)
       {
         kind = TemplateKind::Lib;
@@ -353,6 +377,21 @@ namespace vix::commands::NewCommand
         return 0;
       }
 
+      if (kind == TemplateKind::Game)
+      {
+        if (!gen::generate_game_project(projectDir, projName, genErr))
+        {
+          vix::cli::util::err_line(std::cerr, "Failed to create project files.");
+          vix::cli::util::warn_line(std::cerr, genErr);
+          return 1;
+        }
+
+        vix::cli::util::ok_line(std::cout, "Project created.");
+        vix::cli::util::kv(std::cout, "Location", projectDir.string());
+        gen::print_next_steps_game(projectDir, projName);
+        return 0;
+      }
+
       if (kind == TemplateKind::App)
       {
         if (!gen::generate_app_project(projectDir, projName, features, genErr))
@@ -401,7 +440,9 @@ namespace vix::commands::NewCommand
         << "  vix new api\n"
         << "  vix new .\n"
         << "  vix new tree --lib\n"
+        << "  vix new mario --game\n"
         << "  vix new shop --template vue\n"
+        << "  vix new platformer --template game\n"
         << "  vix new blog -d ./projects\n"
         << "  vix new api --force\n\n"
 
@@ -411,12 +452,12 @@ namespace vix::commands::NewCommand
         << "  • Creates a vix.json manifest\n"
         << "  • For apps, creates an executable target matching the project name\n"
         << "  • For libraries, creates a header-only CMake interface target\n"
-        << "  • Applies the selected template (app or library)\n\n"
+        << "  • Applies the selected template (app, game, library, or Vue)\n\n"
 
-        << "Options\n"
         << "  --app       Generate an application (default)\n"
+        << "  --game      Generate a Vix game project\n"
         << "  --lib       Generate a header-only library\n"
-        << "  --template  Project template, currently: vue\n"
+        << "  --template  Project template, currently: vue, game\n"
         << "  -d, --dir   Base directory for project creation\n"
         << "  --force     Overwrite existing directory\n\n"
 
@@ -425,6 +466,11 @@ namespace vix::commands::NewCommand
         << "  vix build\n"
         << "  vix run\n\n"
 
+        << "Game workflow\n"
+        << "  cd mario/\n"
+        << "  vix build\n"
+        << "  vix run\n\n"
+
         << "Library workflow\n"
         << "  cd tree/\n"
         << "  vix build --build-target all\n"

src/commands/new/NewGenerator.cpp

@@ -268,6 +268,50 @@ namespace vix::commands::new_cmd::generator
     return true;
   }
 
+  // ------------------------------------------------------------------
+  // Game
+  // ------------------------------------------------------------------
+
+  bool generate_game_project(
+      const fs::path &projectDir,
+      const std::string &projName,
+      std::string &err)
+  {
+    const fs::path srcDir = projectDir / "src";
+    const fs::path assetsDir = projectDir / "assets";
+
+    if (!ensure_dir(srcDir, err))
+      return false;
+
+    if (!ensure_dir(assetsDir, err))
+      return false;
+
+    if (!write_text_file(srcDir / "main.cpp",
+                         tpl::make_game_main_cpp(projName), err))
+      return false;
+
+    if (!write_text_file(projectDir / "game.package.json",
+                         tpl::make_game_package_json(projName), err))
+      return false;
+
+    if (!write_text_file(projectDir / "README.md",
+                         tpl::make_readme_game(projName), err))
+      return false;
+
+    if (!write_text_file(projectDir / "vix.json",
+                         tpl::make_vix_json_game(projName), err))
+      return false;
+
+    if (!write_text_file(projectDir / "vix.app",
+                         tpl::make_project_manifest_game(projName), err))
+      return false;
+
+    if (!write_text_file(assetsDir / ".gitkeep", "", err))
+      return false;
+
+    return true;
+  }
+
   // ------------------------------------------------------------------
   // Post-generation output
   // ------------------------------------------------------------------
@@ -294,4 +338,11 @@ namespace vix::commands::new_cmd::generator
     out::print_creation_lib(projectDir, projName);
   }
 
+  void print_next_steps_game(
+      const fs::path &projectDir,
+      const std::string &projName)
+  {
+    out::print_creation_game(projectDir, projName);
+  }
+
 } // namespace vix::commands::new_cmd::generator

src/commands/new/NewOutput.cpp

@@ -98,6 +98,15 @@ namespace vix::commands::new_cmd::output
     print_command_step(4, "vix tests", "run tests");
   }
 
+  static void print_steps_game(const std::string &projName)
+  {
+    section("next");
+
+    print_command_step(1, "cd " + projName + "/", "enter project");
+    print_command_step(2, "vix build", "compile");
+    print_command_step(3, "vix run", "start game");
+  }
+
   // ------------------------------------------------------------------
   // High-level entry points
   // ------------------------------------------------------------------
@@ -130,4 +139,13 @@ namespace vix::commands::new_cmd::output
     print_steps_lib(projName);
   }
 
+  void print_creation_game(
+      const std::filesystem::path & /*projectDir*/,
+      const std::string &projName)
+  {
+    print_banner(projName, "game");
+    sep();
+    print_steps_game(projName);
+  }
+
 } // namespace vix::commands::new_cmd::output