@repokit/core 2.0.6 → 2.1.0

package/Cargo.lock

@@ -169,7 +169,7 @@ checksum = "a96887878f22d7bad8a3b6dc5b7440e0ada9a245242924394987b21cf2210a4c"
 
 [[package]]
 name = "repokit"
-version = "2.0.6"
+version = "2.1.0"
 dependencies = [
  "alphanumeric-sort",
  "colored",
@@ -246,9 +246,9 @@ dependencies = [
 
 [[package]]
 name = "tokio"
-version = "1.49.0"
+version = "1.50.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "72a2903cd7736441aac9df9d7688bd0ce48edccaadf181c3b90be801e81d3d86"
+checksum = "27ad5e34374e03cfffefc301becb44e9dc3c17584f414349ebe29ed26661822d"
 dependencies = [
  "pin-project-lite",
 ]

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "repokit"
-version = "2.0.6"
+version = "2.1.0"
 edition = "2024"
 
 [[bin]]
@@ -13,6 +13,6 @@ serde_json = "1.0"
 colored = "3"
 normalize-path = "0.2.1"
 alphanumeric-sort = "1.5.5"
-tokio = "1.49.0"
+tokio = "1.50.0"
 ignore = "0.4.25"
 regex = { version = "1.12.3", features = ["std", "unicode"] }

package/README.md

@@ -228,6 +228,51 @@ The commands you register onto the repokit toolchain will always be invoked usin
 
 If your command needs to reason about the file system, keep this in mind.
 
+### Themes
+
+The Repokit CLI can be customized to support themes that better match your team's visual preferences.
+
+Repokit comes with 4 pre-built themes that you can use in your `RepoKitConfig`.
+
+```typescript
+import {
+  RepoKitConfig,
+  SeeingRed, // A red theme
+  TheBlues, // A blue theme
+  Green, // A green theme
+} from "@repokit/core";
+
+export const Kit = new RepoKitConfig({
+  project: "My Project",
+  theme: SeeingRed, // Specify a theme here
+});
+```
+
+By omitting the `theme` property `RepoKit` will use its default visuals.
+
+In addition to built-in themes, you can create your own using the `RepoKitTheme`
+
+```typescript
+import { RepoKitConfig, RepoKitTheme } from "@repokit/core";
+
+export const Kit = new RepoKitConfig({
+  project: "My Project",
+  theme: new RepoKitTheme({
+    prefixColor: "rgb(220, 36, 91)",
+    commandColor: "rgb(220, 36, 36)",
+    subcommandColor: "rgb(220, 131, 36)",
+    argColor: "rgb(220, 205, 36)",
+    descriptionColor: "rgb(179, 100, 151)",
+    errorPrefixColor: "rgb(220, 36, 39)",
+    highlightColor: "rgb(237, 175, 41)",
+  }),
+});
+```
+
+All properties on the `RepoKitTheme` are optional overrides for `RepoKit`'s default styling. A color can be any CSS-valid `rgb()` string.
+
+<img src="media/seeing-red.webp" width="100%" alt="seeing red theme" />
+
 ## Motivation
 
 I worked in a codebase at Google that used just about every programming language in existence. Each team had their own methodology for exposing commands, scripts, and API's for their team's day-to-day development needs.

package/dist/RepoKitConfig.d.mts

@@ -1,12 +1,15 @@
+import { RepoKitTheme } from "./RepoKitTheme.mjs";
 import { ICommand, IRepoKitConfig } from "./types.mjs";
 import { RepoKitCommand } from "./RepoKitCommand.mjs";
 
 //#region externals/RepoKitConfig.d.ts
-declare class RepoKitConfig implements Required<IRepoKitConfig> {
+declare class RepoKitConfig {
   project: string;
+  theme?: RepoKitTheme;
   thirdParty: RepoKitCommand[];
   commands: Record<string, ICommand>;
   constructor({
+    theme,
     project,
     commands,
     thirdParty

package/dist/RepoKitConfig.mjs

@@ -2,9 +2,11 @@ import { RepoKitCommand } from "./RepoKitCommand.mjs";
 //#region externals/RepoKitConfig.ts
 var RepoKitConfig = class {
 	project;
+	theme;
 	thirdParty;
 	commands;
-	constructor({ project, commands = {}, thirdParty = [] }) {
+	constructor({ theme, project, commands = {}, thirdParty = [] }) {
+		this.theme = theme;
 		this.project = project;
 		this.commands = commands;
 		this.thirdParty = thirdParty.map((command) => new RepoKitCommand(command));

package/dist/RepoKitTheme.d.mts

@@ -0,0 +1,47 @@
+import { RGBString } from "./types.mjs";
+
+//#region externals/RepoKitTheme.d.ts
+/**
+ * Repokit Theme
+ *
+ * A repokit theme allows you to customize the color
+ * usage of the CLI by adding a `RepoKitTheme` instance
+ * to your `RepoKitConfig`
+ *
+ * ```typescript
+ * import { RepoKitConfig, RepoKitTheme } from "@repokit/core";
+ *
+ * export const RepoKit = new RepoKitConfig({
+ *   project: "Repokit",
+ *   theme: new RepoKitTheme({
+ *     prefixColor: "rgb(220, 36, 91)",
+ *     commandColor: "rgb(220, 36, 36)",
+ *     subcommandColor: "rgb(220, 131, 36)",
+ *     argColor: "rgb(220, 205, 36)",
+ *     descriptionColor: "rgb(95, 28, 71)",
+ *     errorPrefixColor: "rgb(220, 36, 39)",
+ *     hightlightColor: "rgb(8, 98, 255)",
+ *   }),
+ * });
+ * ```
+ */
+declare class RepoKitTheme {
+  prefixColor?: RGBString;
+  commandColor?: RGBString;
+  subcommandColor?: RGBString;
+  argColor?: RGBString;
+  descriptionColor?: RGBString;
+  errorPrefixColor?: RGBString;
+  highlightColor?: RGBString;
+  constructor({
+    prefixColor,
+    commandColor,
+    subcommandColor,
+    argColor,
+    descriptionColor,
+    errorPrefixColor,
+    highlightColor
+  }: RepoKitTheme);
+}
+//#endregion
+export { RepoKitTheme };

package/dist/RepoKitTheme.mjs

@@ -0,0 +1,45 @@
+//#region externals/RepoKitTheme.ts
+/**
+* Repokit Theme
+*
+* A repokit theme allows you to customize the color
+* usage of the CLI by adding a `RepoKitTheme` instance
+* to your `RepoKitConfig`
+*
+* ```typescript
+* import { RepoKitConfig, RepoKitTheme } from "@repokit/core";
+*
+* export const RepoKit = new RepoKitConfig({
+*   project: "Repokit",
+*   theme: new RepoKitTheme({
+*     prefixColor: "rgb(220, 36, 91)",
+*     commandColor: "rgb(220, 36, 36)",
+*     subcommandColor: "rgb(220, 131, 36)",
+*     argColor: "rgb(220, 205, 36)",
+*     descriptionColor: "rgb(95, 28, 71)",
+*     errorPrefixColor: "rgb(220, 36, 39)",
+*     hightlightColor: "rgb(8, 98, 255)",
+*   }),
+* });
+* ```
+*/
+var RepoKitTheme = class {
+	prefixColor;
+	commandColor;
+	subcommandColor;
+	argColor;
+	descriptionColor;
+	errorPrefixColor;
+	highlightColor;
+	constructor({ prefixColor, commandColor, subcommandColor, argColor, descriptionColor, errorPrefixColor, highlightColor }) {
+		this.prefixColor = prefixColor;
+		this.commandColor = commandColor;
+		this.subcommandColor = subcommandColor;
+		this.argColor = argColor;
+		this.descriptionColor = descriptionColor;
+		this.errorPrefixColor = errorPrefixColor;
+		this.highlightColor = highlightColor;
+	}
+};
+//#endregion
+export { RepoKitTheme };

package/dist/TSCompiler.mjs

@@ -16,14 +16,10 @@ var TSCompiler = class {
 	static compile(path) {
 		const compiler = register(this.compilerOptions);
 		compiler.enabled(true);
-		const result = this.import(path);
+		const result = __require(path);
 		compiler.enabled(false);
 		return result;
 	}
-	static import(filePath) {
-		const _module = __require(filePath);
-		return _module?.__esModule ? _module : { default: _module };
-	}
 };
 //#endregion
 export { TSCompiler };

package/dist/Themes.d.mts

@@ -0,0 +1,8 @@
+import { RepoKitTheme } from "./RepoKitTheme.mjs";
+
+//#region externals/Themes.d.ts
+declare const SeeingRed: RepoKitTheme;
+declare const TheBlues: RepoKitTheme;
+declare const Green: RepoKitTheme;
+//#endregion
+export { Green, SeeingRed, TheBlues };

package/dist/Themes.mjs

@@ -0,0 +1,31 @@
+import { RepoKitTheme } from "./RepoKitTheme.mjs";
+//#region externals/Themes.ts
+const SeeingRed = new RepoKitTheme({
+	prefixColor: "rgb(220, 36, 91)",
+	commandColor: "rgb(220, 36, 36)",
+	subcommandColor: "rgb(220, 131, 36)",
+	argColor: "rgb(220, 205, 36)",
+	descriptionColor: "rgb(179, 100, 151)",
+	errorPrefixColor: "rgb(220, 36, 39)",
+	highlightColor: "rgb(237, 175, 41)"
+});
+const TheBlues = new RepoKitTheme({
+	prefixColor: "rgb(33, 111, 255)",
+	commandColor: "rgb(52, 96, 255)",
+	subcommandColor: "rgb(0, 157, 255)",
+	argColor: "rgb(40, 175, 253)",
+	descriptionColor: "rgb(100, 165, 179)",
+	errorPrefixColor: "rgb(220, 36, 100)",
+	highlightColor: "rgb(69, 219, 229)"
+});
+const Green = new RepoKitTheme({
+	prefixColor: "rgb(26, 227, 133)",
+	commandColor: "rgb(82, 234, 74)",
+	subcommandColor: "rgb(51, 241, 162)",
+	argColor: "rgb(124, 244, 102)",
+	descriptionColor: "rgb(126, 168, 140)",
+	errorPrefixColor: "rgb(220, 36, 100)",
+	highlightColor: "rgb(25, 206, 91)"
+});
+//#endregion
+export { Green, SeeingRed, TheBlues };

package/dist/index.d.mts

@@ -1,4 +1,6 @@
-import { AsyncTask, ICommand, ILocatedCommand, IRepoKitCommand, IRepoKitConfig } from "./types.mjs";
+import { RepoKitTheme } from "./RepoKitTheme.mjs";
+import { AsyncTask, ICommand, ILocatedCommand, IRepoKitCommand, IRepoKitConfig, RGBString } from "./types.mjs";
 import { RepoKitCommand } from "./RepoKitCommand.mjs";
 import { RepoKitConfig } from "./RepoKitConfig.mjs";
-export { AsyncTask, ICommand, ILocatedCommand, IRepoKitCommand, IRepoKitConfig, RepoKitCommand, RepoKitConfig };
+import { Green, SeeingRed, TheBlues } from "./Themes.mjs";
+export { AsyncTask, Green, ICommand, ILocatedCommand, IRepoKitCommand, IRepoKitConfig, RGBString, RepoKitCommand, RepoKitConfig, RepoKitTheme, SeeingRed, TheBlues };

package/dist/index.mjs

@@ -1,3 +1,5 @@
 import { RepoKitCommand } from "./RepoKitCommand.mjs";
 import { RepoKitConfig } from "./RepoKitConfig.mjs";
-export { RepoKitCommand, RepoKitConfig };
+import { RepoKitTheme } from "./RepoKitTheme.mjs";
+import { Green, SeeingRed, TheBlues } from "./Themes.mjs";
+export { Green, RepoKitCommand, RepoKitConfig, RepoKitTheme, SeeingRed, TheBlues };

package/dist/types.d.mts

@@ -1,3 +1,4 @@
+import { RepoKitTheme } from "./RepoKitTheme.mjs";
 import { RepoKitCommand } from "./RepoKitCommand.mjs";
 
 //#region externals/types.d.ts
@@ -5,6 +6,7 @@ interface IRepoKitConfig {
   project: string;
   thirdParty?: RepoKitCommand[];
   commands?: Record<string, ICommand>;
+  theme?: RepoKitTheme;
 }
 interface IRepoKitCommand {
   name: string;
@@ -21,5 +23,7 @@ interface ILocatedCommand extends IRepoKitCommand {
   location: string;
 }
 type AsyncTask<T> = () => Promise<T>;
+type OptionalSpace = " " | "";
+type RGBString = `rgb(${number},${OptionalSpace}${number},${OptionalSpace}${number})`;
 //#endregion
-export { AsyncTask, ICommand, ILocatedCommand, IRepoKitCommand, IRepoKitConfig };
+export { AsyncTask, ICommand, ILocatedCommand, IRepoKitCommand, IRepoKitConfig, RGBString };

package/externals/RepoKitConfig.ts

@@ -1,12 +1,20 @@
 import { RepoKitCommand } from "./RepoKitCommand";
+import type { RepoKitTheme } from "./RepoKitTheme";
 import type { ICommand, IRepoKitConfig } from "./types";
 /* eslint-disable typescript-eslint(no-misused-spread */
 
-export class RepoKitConfig implements Required<IRepoKitConfig> {
+export class RepoKitConfig {
   project: string;
+  theme?: RepoKitTheme;
   thirdParty: RepoKitCommand[];
   commands: Record<string, ICommand>;
-  constructor({ project, commands = {}, thirdParty = [] }: IRepoKitConfig) {
+  constructor({
+    theme,
+    project,
+    commands = {},
+    thirdParty = [],
+  }: IRepoKitConfig) {
+    this.theme = theme;
     this.project = project;
     this.commands = commands;
     this.thirdParty = thirdParty.map(command => new RepoKitCommand(command));

package/externals/RepoKitTheme.ts

@@ -0,0 +1,52 @@
+import type { RGBString } from "./types";
+
+/**
+ * Repokit Theme
+ *
+ * A repokit theme allows you to customize the color
+ * usage of the CLI by adding a `RepoKitTheme` instance
+ * to your `RepoKitConfig`
+ *
+ * ```typescript
+ * import { RepoKitConfig, RepoKitTheme } from "@repokit/core";
+ *
+ * export const RepoKit = new RepoKitConfig({
+ *   project: "Repokit",
+ *   theme: new RepoKitTheme({
+ *     prefixColor: "rgb(220, 36, 91)",
+ *     commandColor: "rgb(220, 36, 36)",
+ *     subcommandColor: "rgb(220, 131, 36)",
+ *     argColor: "rgb(220, 205, 36)",
+ *     descriptionColor: "rgb(95, 28, 71)",
+ *     errorPrefixColor: "rgb(220, 36, 39)",
+ *     hightlightColor: "rgb(8, 98, 255)",
+ *   }),
+ * });
+ * ```
+ */
+export class RepoKitTheme {
+  prefixColor?: RGBString;
+  commandColor?: RGBString;
+  subcommandColor?: RGBString;
+  argColor?: RGBString;
+  descriptionColor?: RGBString;
+  errorPrefixColor?: RGBString;
+  highlightColor?: RGBString;
+  constructor({
+    prefixColor,
+    commandColor,
+    subcommandColor,
+    argColor,
+    descriptionColor,
+    errorPrefixColor,
+    highlightColor,
+  }: RepoKitTheme) {
+    this.prefixColor = prefixColor;
+    this.commandColor = commandColor;
+    this.subcommandColor = subcommandColor;
+    this.argColor = argColor;
+    this.descriptionColor = descriptionColor;
+    this.errorPrefixColor = errorPrefixColor;
+    this.highlightColor = highlightColor;
+  }
+}

package/externals/TSCompiler.ts

@@ -19,13 +19,8 @@ export class TSCompiler {
   public static compile<T extends Record<string, unknown>>(path: string) {
     const compiler = register(this.compilerOptions);
     compiler.enabled(true);
-    const result = this.import(path) as T;
+    const result = require(path) as T;
     compiler.enabled(false);
     return result;
   }
-
-  private static import(filePath: string) {
-    const _module = require(filePath);
-    return _module?.__esModule ? _module : { default: _module };
-  }
 }

package/externals/Themes.ts

@@ -0,0 +1,31 @@
+import { RepoKitTheme } from "./RepoKitTheme";
+
+export const SeeingRed = new RepoKitTheme({
+  prefixColor: "rgb(220, 36, 91)",
+  commandColor: "rgb(220, 36, 36)",
+  subcommandColor: "rgb(220, 131, 36)",
+  argColor: "rgb(220, 205, 36)",
+  descriptionColor: "rgb(179, 100, 151)",
+  errorPrefixColor: "rgb(220, 36, 39)",
+  highlightColor: "rgb(237, 175, 41)",
+});
+
+export const TheBlues = new RepoKitTheme({
+  prefixColor: "rgb(33, 111, 255)",
+  commandColor: "rgb(52, 96, 255)",
+  subcommandColor: "rgb(0, 157, 255)",
+  argColor: "rgb(40, 175, 253)",
+  descriptionColor: "rgb(100, 165, 179)",
+  errorPrefixColor: "rgb(220, 36, 100)",
+  highlightColor: "rgb(69, 219, 229)",
+});
+
+export const Green = new RepoKitTheme({
+  prefixColor: "rgb(26, 227, 133)",
+  commandColor: "rgb(82, 234, 74)",
+  subcommandColor: "rgb(51, 241, 162)",
+  argColor: "rgb(124, 244, 102)",
+  descriptionColor: "rgb(126, 168, 140)",
+  errorPrefixColor: "rgb(220, 36, 100)",
+  highlightColor: "rgb(25, 206, 91)",
+});

package/externals/index.ts

@@ -1,3 +1,5 @@
 export * from "./RepoKitCommand";
 export * from "./RepoKitConfig";
+export * from "./RepoKitTheme";
+export * from "./Themes";
 export * from "./types";

package/externals/types.ts

@@ -1,9 +1,11 @@
 import type { RepoKitCommand } from "./RepoKitCommand";
+import type { RepoKitTheme } from "./RepoKitTheme";
 
 export interface IRepoKitConfig {
   project: string;
   thirdParty?: RepoKitCommand[];
   commands?: Record<string, ICommand>;
+  theme?: RepoKitTheme;
 }
 
 export interface IRepoKitCommand {
@@ -24,3 +26,8 @@ export interface ILocatedCommand extends IRepoKitCommand {
 }
 
 export type AsyncTask<T> = () => Promise<T>;
+
+type OptionalSpace = " " | "";
+
+export type RGBString =
+  `rgb(${number},${OptionalSpace}${number},${OptionalSpace}${number})`;

package/installation/install.sh

@@ -1,4 +1,4 @@
-CURRENT_VERSION="2.0.6"
+CURRENT_VERSION="2.1.0"
 CWD=$(pwd)
 
 REPLACEMENT="/node_modules"

package/internals/configuration/configuration.rs

@@ -15,7 +15,7 @@ impl Configuration {
             Logger::info(
                 format!(
                     "I found a Repokit configuration without an exported {} instance",
-                    Logger::blue("RepokitConfig")
+                    Logger::with_theme(|theme| theme.highlight("RepokitConfig"))
                 )
                 .as_str(),
             );
@@ -29,7 +29,7 @@ impl Configuration {
         Logger::info(
             format!(
                 "Please fill out this file with your desired settings. Then run {}",
-                Logger::blue_bright("repokit onboard")
+                Logger::with_theme(|theme| theme.highlight("repokit onboard"))
             )
             .as_str(),
         );

package/internals/internal_commands/help.rs

@@ -25,52 +25,62 @@ impl Help {
     }
 
     pub fn log_internal_command(command: &InternalExecutableDefinition) {
-        println!(
-            "{}{} {}",
-            Logger::indent(Some(3)),
-            Logger::blue(&command.name),
-            Logger::gray(&command.description),
-        );
+        Logger::with_theme(|theme| {
+            println!(
+                "{}{} {}",
+                Logger::indent(Some(3)),
+                theme.command(&command.name),
+                theme.description(&command.description),
+            );
+        });
         Help::log_args(&command.args, None);
     }
 
     pub fn log_root_command(command: &RootCommand) {
-        println!(
-            "{}{} {}",
-            Logger::indent(Some(3)),
-            Logger::blue(&command.name),
-            Logger::gray(&command.description),
-        );
+        Logger::with_theme(|theme| {
+            println!(
+                "{}{} {}",
+                Logger::indent(Some(3)),
+                theme.command(&command.name),
+                theme.description(&command.description),
+            );
+        });
         Help::log_args(&command.args, None)
     }
 
     pub fn log_external_command(command: &RepoKitCommand) {
-        println!(
-            "{}{} {}",
-            Logger::indent(Some(3)),
-            Logger::blue(&command.name),
-            Logger::gray(&command.description),
-        );
+        Logger::with_theme(|theme| {
+            println!(
+                "{}{} {}",
+                Logger::indent(Some(3)),
+                theme.command(&command.name),
+                theme.description(&command.description),
+            );
+        });
         println!();
         Help::log_external_subcommands(&command.commands, 6);
         if !command.owner.is_empty() {
-            println!(
-                "\n{}{}{}",
-                Logger::indent(Some(9)),
-                Logger::gray("Owned by: "),
-                Logger::cyan(&command.owner),
-            );
+            Logger::with_theme(|theme| {
+                println!(
+                    "\n{}{}{}",
+                    Logger::indent(Some(9)),
+                    theme.description("Owned by: "),
+                    Logger::cyan(&command.owner),
+                );
+            });
         }
     }
 
     pub fn log_external_subcommands(map: &HashMap<String, CommandDefinition>, indentation: i32) {
         for (name, command) in map {
-            println!(
-                "{}{}{}",
-                Logger::indent(Some(indentation)),
-                Logger::lime(format!("{}: ", name).as_str()),
-                Logger::gray(&command.description),
-            );
+            Logger::with_theme(|theme| {
+                println!(
+                    "{}{}: {}",
+                    Logger::indent(Some(indentation)),
+                    theme.sub_command(name),
+                    theme.description(&command.description),
+                );
+            });
             Help::log_args(&command.args, Some(indentation + 3));
         }
     }
@@ -114,16 +124,18 @@ impl Help {
     }
 
     fn log_args(map: &Option<HashMap<String, String>>, indentation: Option<i32>) {
-        if let Some(args) = map {
-            for (name, description) in args {
-                println!(
-                    "{}{}{}",
-                    Logger::indent(Some(indentation.unwrap_or(6))),
-                    Logger::green(name.as_str()),
-                    Logger::gray(format!(" {}", description).as_str()),
-                );
+        Logger::with_theme(|theme| {
+            if let Some(args) = map {
+                for (name, description) in args {
+                    println!(
+                        "{}{} {}",
+                        Logger::indent(Some(indentation.unwrap_or(6))),
+                        theme.arg(name),
+                        theme.description(description)
+                    );
+                }
             }
-        }
+        });
     }
 
     fn sort_internal(

package/internals/internal_commands/list_commands.rs

@@ -31,7 +31,7 @@ impl ListCommands {
                     "<scope>",
                     format!(
                         "The scope of the commands you wish to list. Specify one of {}",
-                        Logger::blue(SCOPES.join(" | ").as_str())
+                        Logger::with_theme(|theme| theme.highlight(SCOPES.join(" | ").as_str()))
                     )
                     .as_str(),
                 )],
@@ -48,7 +48,7 @@ impl ListCommands {
         Logger::exit_with_info(
             format!(
                 "Please specify a scope to list the commands of. Select one of {}",
-                Logger::blue_bright(SCOPES.join(" | ").as_str())
+                Logger::with_theme(|theme| theme.highlight(SCOPES.join(" | ").as_str()))
             )
             .as_str(),
         );
@@ -88,7 +88,7 @@ impl InternalExecutable for ListCommands {
             Logger::exit_with_info(
                 format!(
                     "I could not find any commands matching {}",
-                    Logger::blue_bright(&full_query)
+                    Logger::with_theme(|theme| theme.highlight(&full_query))
                 )
                 .as_str(),
             );

package/internals/internal_commands/locate_command.rs

@@ -54,13 +54,19 @@ impl InternalExecutable for LocateCommand {
             Logger::exit_with_info("Please specify a command to locate");
         }
         let command = &args[0];
-        Logger::info(format!("Locating a command named {}", Logger::blue_bright(command)).as_str());
+        Logger::info(
+            format!(
+                "Locating a command named {}",
+                Logger::with_theme(|theme| theme.highlight(command))
+            )
+            .as_str(),
+        );
         self.search_externals(command);
         self.search_root(command);
         Logger::exit_with_error(
             format!(
                 "I could not find a command named {}",
-                Logger::blue_bright(command)
+                Logger::with_theme(|theme| theme.highlight(command))
             )
             .as_str(),
         );

package/internals/internal_commands/onboarder.rs

@@ -31,12 +31,18 @@ impl Onboarder {
 
 impl InternalExecutable for Onboarder {
     fn run(&self, _: Vec<String>, _: &HashMap<String, Box<dyn InternalExecutable>>) {
-        Logger::info(format!("Welcome to {}", Logger::blue_bright("Repokit")).as_str());
+        Logger::info(
+            format!(
+                "Welcome to {}",
+                Logger::with_theme(|theme| theme.highlight("Repokit"))
+            )
+            .as_str(),
+        );
         Logger::info(
             "Repokit is a tool designed to self-document and publish developer facing workflows in a single CLI",
         );
         Logger::info(
-            format!("As you develop new features in your codebase, you can publish commands, API's, and tools to the {} CLI by running", Logger::blue_bright("Repokit")).as_str()
+            format!("As you develop new features in your codebase, you can publish commands, API's, and tools to the {} CLI by running", Logger::with_theme(|theme|theme.highlight("Repokit"))).as_str()
         );
         Logger::log_file_path("repokit register ./path/to/your-feature");
         Logger::info(
@@ -45,12 +51,12 @@ impl InternalExecutable for Onboarder {
         Logger::info(
             format!(
                 "The {} CLI will automatically detect these files and add them to its toolchain",
-                Logger::blue_bright("Repokit")
+                Logger::with_theme(|theme| theme.highlight("Repokit"))
             )
             .as_str(),
         );
         Logger::info(
-            format!("As your codebase grows, your {} CLI will continue to track all of the published workflows created by your team", Logger::blue_bright("Repokit")).as_str()
+            format!("As your codebase grows, your {} CLI will continue to track all of the published workflows created by your team", Logger::with_theme(|theme|theme.highlight("Repokit"))).as_str()
         );
         Logger::space_around("It's your living source of knowledge and documentation");
     }

package/internals/internal_commands/register_command.rs

@@ -50,7 +50,7 @@ impl RegisterCommand {
             Logger::info(
                 format!(
                     "Creating the path {} in your file system",
-                    Logger::blue_bright(path_arg.as_str())
+                    Logger::with_theme(|theme| theme.highlight(path_arg.as_str()))
                 )
                 .as_str(),
             );
@@ -64,13 +64,13 @@ impl RegisterCommand {
             Logger::error(
                 format!(
                     "A {} file already exists in this directory",
-                    Logger::blue_bright("Commands.ts")
+                    Logger::with_theme(|theme| theme.highlight("Commands.ts"))
                 )
                 .as_str(),
             );
             Logger::info(format!(
                 "You can append additional commands to the existing {} instance or export another one",
-                Logger::blue_bright("RepoKitCommand")
+                Logger::with_theme(|theme| theme.highlight("RepoKitCommand"))
             ).as_str());
             process::exit(0);
         }

package/internals/internal_commands/search_commands.rs

@@ -98,7 +98,7 @@ impl SearchCommands {
         Logger::info(
             format!(
                 "Matched {} command{} in your repokit config",
-                Logger::blue_bright(total.to_string().as_str()),
+                Logger::with_theme(|theme| theme.highlight(total.to_string().as_str())),
                 plural_appendage,
             )
             .as_str(),
@@ -124,7 +124,7 @@ impl SearchCommands {
         Logger::info(
             format!(
                 "Matched {} internal command{}",
-                Logger::blue_bright(total.to_string().as_str()),
+                Logger::with_theme(|theme| theme.highlight(total.to_string().as_str())),
                 plural_appendage,
             )
             .as_str(),
@@ -140,7 +140,7 @@ impl SearchCommands {
         Logger::info(
             format!(
                 "Matched {} registered command{}",
-                Logger::blue_bright(total.to_string().as_str()),
+                Logger::with_theme(|theme| theme.highlight(total.to_string().as_str())),
                 plural_appendage,
             )
             .as_str(),

package/internals/internal_commands/upgrade_repokit.rs

@@ -41,7 +41,11 @@ impl UpgradeRepoKit {
             let path = Path::new(&self.scope.root).join(lock_file).normalize();
             if path.exists() && path.is_file() {
                 Logger::info(
-                    format!("Detected {} installation", Logger::blue_bright(manager)).as_str(),
+                    format!(
+                        "Detected {} installation",
+                        Logger::with_theme(|theme| theme.highlight(manager))
+                    )
+                    .as_str(),
                 );
                 return command_prefix;
             }

package/internals/internal_filesystem/internal_filesystem.rs

@@ -49,8 +49,8 @@ impl InternalFileSystem {
             Logger::exit_with_info(
                 format!(
                     "To start using {}, please initialize your git repository by running {}",
-                    Logger::blue("Repokit"),
-                    Logger::green_bright("git init")
+                    Logger::with_theme(|theme| theme.highlight("Repokit")),
+                    Logger::with_theme(|theme| theme.highlight("git init"))
                 )
                 .as_str(),
             );

package/internals/logger/logger.rs

@@ -1,12 +1,18 @@
 use std::process::exit;
 use std::sync::LazyLock;
 use std::sync::Mutex;
+use std::sync::MutexGuard;
 
-use colored::{ColoredString, Colorize, CustomColor};
+use colored::{ColoredString, Colorize};
+
+use crate::themes::theme::Theme;
+use crate::themes::theme_registry::ThemeRegistry;
 
 static REGISTERED_NAME: LazyLock<Mutex<String>> =
     LazyLock::new(|| Mutex::new("Repokit".to_string()));
 
+static THEMES: LazyLock<Mutex<ThemeRegistry>> = LazyLock::new(|| Mutex::new(ThemeRegistry::new()));
+
 pub struct Logger {}
 
 impl Logger {
@@ -37,7 +43,11 @@ impl Logger {
     }
 
     pub fn log_file_path(path: &str) {
-        println!("\n{}{}\n", Logger::indent(None), Logger::blue_bright(path));
+        println!(
+            "\n{}{}\n",
+            Logger::indent(None),
+            Logger::with_theme(|theme| theme.highlight(path))
+        );
     }
 
     pub fn indent(times: Option<i32>) -> String {
@@ -45,54 +55,10 @@ impl Logger {
         " ".repeat(indentation.try_into().unwrap())
     }
 
-    pub fn blue(message: &str) -> ColoredString {
-        message.bright_blue()
-    }
-
-    pub fn blue_bright(message: &str) -> ColoredString {
-        message.bright_blue().bold()
-    }
-
-    pub fn magenta_bright(message: &str) -> ColoredString {
-        message.bright_magenta().bold()
-    }
-
-    pub fn magenta(message: &str) -> ColoredString {
-        message.magenta()
-    }
-
-    pub fn green(message: &str) -> ColoredString {
-        message.green()
-    }
-
-    pub fn green_bright(message: &str) -> ColoredString {
-        message.bright_green()
-    }
-
     pub fn cyan(message: &str) -> ColoredString {
         message.cyan()
     }
 
-    pub fn cyan_bright(message: &str) -> ColoredString {
-        message.bright_cyan().bold()
-    }
-
-    pub fn gray(message: &str) -> ColoredString {
-        message.custom_color(CustomColor {
-            r: 128,
-            g: 128,
-            b: 128,
-        })
-    }
-
-    pub fn lime(message: &str) -> ColoredString {
-        message.custom_color(CustomColor {
-            r: 175,
-            g: 247,
-            b: 7,
-        })
-    }
-
     pub fn file_create_error() {
         Logger::file_error("create a file");
     }
@@ -113,6 +79,15 @@ impl Logger {
         Logger::log_file_path("https://github.com/alexfigliolia/repokit/issues");
     }
 
+    pub fn with_theme<R>(func: impl Fn(&Theme) -> R) -> R {
+        Logger::with_registry(|registry| func(&registry.theme))
+    }
+
+    pub fn with_registry<R>(func: impl Fn(MutexGuard<'_, ThemeRegistry>) -> R) -> R {
+        let registry = THEMES.lock().unwrap();
+        func(registry)
+    }
+
     fn file_error(operation: &str) {
         Logger::info(format!("I was unable to {operation} in your repository").as_str());
         Logger::error("Please verify the permissions on your working directory or file a bug here");
@@ -120,15 +95,13 @@ impl Logger {
         exit(0);
     }
 
-    fn info_prefix() -> ColoredString {
-        format!("{}: ", *REGISTERED_NAME.lock().unwrap())
-            .bright_magenta()
-            .bold()
+    fn info_prefix() -> String {
+        Logger::with_theme(|theme| format!("{}: ", theme.prefix(&REGISTERED_NAME.lock().unwrap())))
     }
 
-    fn error_prefix() -> ColoredString {
-        format!("{}: ", *REGISTERED_NAME.lock().unwrap())
-            .red()
-            .bold()
+    fn error_prefix() -> String {
+        Logger::with_theme(|theme| {
+            format!("{}: ", theme.error_prefix(&REGISTERED_NAME.lock().unwrap()))
+        })
     }
 }

package/internals/main.rs

@@ -11,6 +11,7 @@ mod internal_commands;
 mod internal_filesystem;
 mod logger;
 mod repokit;
+mod themes;
 mod validations;
 
 fn main() {

package/internals/repokit/interfaces.rs

@@ -2,6 +2,8 @@ use std::collections::HashMap;
 
 use serde::Deserialize;
 
+use crate::themes::theme::RepoKitTheme;
+
 #[derive(Debug, Deserialize, Clone)]
 pub struct CommandDefinition {
     pub command: String,
@@ -33,6 +35,7 @@ pub struct RepoKitConfig {
     pub project: String,
     pub thirdParty: Vec<RepoKitCommand>,
     pub commands: HashMap<String, CommandDefinition>,
+    pub theme: Option<RepoKitTheme>,
 }
 
 #[derive(Debug, Deserialize, Clone)]

package/internals/repokit/repokit.rs

@@ -23,6 +23,9 @@ pub struct RepoKit {
 impl RepoKit {
     pub fn new(root: String, configuration: RepoKitConfig) -> RepoKit {
         Logger::set_name(&configuration.project);
+        if let Some(theme) = &configuration.theme {
+            Logger::with_registry(|mut registry| registry.register(theme))
+        }
         RepoKit {
             scope: RepoKitScope {
                 root,
@@ -113,7 +116,7 @@ impl RepoKit {
         Logger::info(
             format!(
                 "I'm not aware of a command named {}",
-                Logger::blue_bright(command)
+                Logger::with_theme(|theme| theme.highlight(command))
             )
             .as_str(),
         );
@@ -123,15 +126,15 @@ impl RepoKit {
         Logger::info(
             format!(
                 "The command {} was not found on {}",
-                Logger::blue_bright(sub_command),
-                Logger::blue_bright(&command.name)
+                Logger::with_theme(|theme| theme.highlight(sub_command)),
+                Logger::with_theme(|theme| theme.highlight(&command.name))
             )
             .as_str(),
         );
         Logger::info(
             format!(
                 "Here are the commands that belong to {}",
-                Logger::blue_bright(&command.name)
+                Logger::with_theme(|theme| theme.highlight(&command.name))
             )
             .as_str(),
         );
@@ -142,7 +145,7 @@ impl RepoKit {
         Logger::info(
             format!(
                 "Listing available commands for {}\n",
-                Logger::blue(&command.name)
+                Logger::with_theme(|theme| theme.command(&command.name))
             )
             .as_str(),
         );

package/internals/themes/mod.rs

@@ -0,0 +1,2 @@
+pub mod theme;
+pub mod theme_registry;

package/internals/themes/theme.rs

@@ -0,0 +1,130 @@
+use colored::{Color, ColoredString, Colorize};
+use serde::Deserialize;
+
+pub struct Theme {
+    prefixColor: Color,
+    commandColor: Color,
+    subcommandColor: Color,
+    argColor: Color,
+    descriptionColor: Color,
+    errorPrefixColor: Color,
+    highlightColor: Color,
+}
+
+impl Theme {
+    pub fn new(colors: ThemeInputColors) -> Theme {
+        Theme::from(colors)
+    }
+
+    pub fn prefix(&self, msg: &str) -> ColoredString {
+        msg.color(self.prefixColor).bold()
+    }
+
+    pub fn command(&self, msg: &str) -> ColoredString {
+        msg.color(self.commandColor)
+    }
+
+    pub fn sub_command(&self, msg: &str) -> ColoredString {
+        msg.color(self.subcommandColor)
+    }
+
+    pub fn arg(&self, msg: &str) -> ColoredString {
+        msg.color(self.argColor)
+    }
+
+    pub fn description(&self, msg: &str) -> ColoredString {
+        msg.color(self.descriptionColor)
+    }
+
+    pub fn error_prefix(&self, msg: &str) -> ColoredString {
+        msg.color(self.errorPrefixColor).bold()
+    }
+
+    pub fn highlight(&self, msg: &str) -> ColoredString {
+        msg.color(self.highlightColor)
+    }
+
+    pub fn from_configuration(theme: &RepoKitTheme) -> Theme {
+        let copy = theme.clone();
+        Theme::new(ThemeInputColors {
+            prefixColor: Theme::parse_rgb(copy.prefixColor),
+            commandColor: Theme::parse_rgb(copy.commandColor),
+            subcommandColor: Theme::parse_rgb(copy.subcommandColor),
+            argColor: Theme::parse_rgb(copy.argColor),
+            descriptionColor: Theme::parse_rgb(copy.descriptionColor),
+            errorPrefixColor: Theme::parse_rgb(copy.errorPrefixColor),
+            highlightColor: Theme::parse_rgb(copy.highlightColor),
+        })
+    }
+
+    fn parse_rgb(rgb_str: Option<String>) -> Option<Color> {
+        match rgb_str {
+            Some(rgb) => {
+                let trimmed = rgb
+                    .strip_prefix("rgb(")
+                    .and_then(|s| s.strip_suffix(')'))
+                    .map(|s| s.trim())?;
+
+                // 2. Split the remaining string by commas.
+                let parts: Vec<&str> = trimmed.split(',').collect();
+
+                if parts.len() == 3 {
+                    // 3. Trim whitespace from each part and parse to a u8.
+                    //    `.parse()` returns a `Result`, so we use `.ok()` to convert to an `Option`,
+                    //    and the `?` operator to return early if any parse fails.
+                    let r = parts[0].trim().parse::<u8>().ok()?;
+                    let g = parts[1].trim().parse::<u8>().ok()?;
+                    let b = parts[2].trim().parse::<u8>().ok()?;
+
+                    Some(Color::TrueColor { r, g, b })
+                } else {
+                    None
+                }
+            }
+            None => None,
+        }
+    }
+}
+
+pub struct ThemeInputColors {
+    pub prefixColor: Option<Color>,
+    pub commandColor: Option<Color>,
+    pub subcommandColor: Option<Color>,
+    pub argColor: Option<Color>,
+    pub descriptionColor: Option<Color>,
+    pub errorPrefixColor: Option<Color>,
+    pub highlightColor: Option<Color>,
+}
+
+impl From<ThemeInputColors> for Theme {
+    fn from(input: ThemeInputColors) -> Theme {
+        Theme {
+            prefixColor: input.prefixColor.unwrap_or(Color::BrightMagenta),
+            commandColor: input.commandColor.unwrap_or(Color::BrightBlue),
+            subcommandColor: input.subcommandColor.unwrap_or(Color::TrueColor {
+                r: 175,
+                g: 247,
+                b: 7,
+            }),
+            argColor: input.argColor.unwrap_or(Color::Green),
+            descriptionColor: input.descriptionColor.unwrap_or(Color::TrueColor {
+                r: 128,
+                g: 128,
+                b: 128,
+            }),
+            errorPrefixColor: input.errorPrefixColor.unwrap_or(Color::Red),
+            highlightColor: input.highlightColor.unwrap_or(Color::BrightBlue),
+        }
+    }
+}
+
+#[derive(Debug, Deserialize, Clone)]
+pub struct RepoKitTheme {
+    pub prefixColor: Option<String>,
+    pub commandColor: Option<String>,
+    pub subcommandColor: Option<String>,
+    pub argColor: Option<String>,
+    pub descriptionColor: Option<String>,
+    pub errorPrefixColor: Option<String>,
+    pub highlightColor: Option<String>,
+}

package/internals/themes/theme_registry.rs

@@ -0,0 +1,29 @@
+use crate::themes::theme::{RepoKitTheme, Theme, ThemeInputColors};
+
+pub struct ThemeRegistry {
+    pub theme: Theme,
+}
+
+impl ThemeRegistry {
+    pub fn new() -> ThemeRegistry {
+        ThemeRegistry {
+            theme: ThemeRegistry::default_theme(),
+        }
+    }
+
+    pub fn register(&mut self, theme: &RepoKitTheme) {
+        self.theme = Theme::from_configuration(theme);
+    }
+
+    fn default_theme() -> Theme {
+        Theme::new(ThemeInputColors {
+            prefixColor: None,
+            commandColor: None,
+            subcommandColor: None,
+            argColor: None,
+            descriptionColor: None,
+            errorPrefixColor: None,
+            highlightColor: None,
+        })
+    }
+}

package/internals/validations/command_validations.rs

@@ -61,7 +61,7 @@ impl CommandValidations {
                 Logger::info(
                     format!(
                         "I encountered a command named {} that conflicts with one of my internals",
-                        Logger::blue_bright(name),
+                        Logger::with_theme(|theme| theme.highlight(name)),
                     )
                     .as_str(),
                 );
@@ -81,8 +81,8 @@ impl CommandValidations {
                 Logger::info(
                     format!(
                         "I encountered a command named {} in your {} file that conflicts with one of my internals",
-                        Logger::blue_bright(name),
-                        Logger::blue_bright("repokit.ts"),
+                        Logger::with_theme(|theme|theme.highlight(name)),
+                        Logger::with_theme(|theme|theme.highlight("repokit.ts")),
                     )
                     .as_str(),
                 );
@@ -117,8 +117,8 @@ impl CommandValidations {
     fn on_external_root_collision(&self, command: &RepoKitCommand) {
         Logger::info(format!(
                 "I encountered a package command named {} that conflicts with a command in your {} file",
-                Logger::blue_bright(&command.name),
-                Logger::blue_bright("repokit.ts")
+                Logger::with_theme(|theme|theme.highlight(&command.name)),
+                Logger::with_theme(|theme|theme.highlight("repokit.ts"))
             )
             .as_str(),
         );
@@ -131,7 +131,7 @@ impl CommandValidations {
         Logger::info(
             format!(
                 "I encountered two packages with the name {}",
-                Logger::blue_bright(&command.name),
+                Logger::with_theme(|theme| theme.highlight(&command.name)),
             )
             .as_str(),
         );
@@ -139,12 +139,12 @@ impl CommandValidations {
         println!(
             "{}1. {}",
             Logger::indent(None),
-            Logger::blue_bright(collision_path)
+            Logger::with_theme(|theme| theme.highlight(collision_path))
         );
         println!(
             "{}2. {}\n",
             Logger::indent(None),
-            Logger::blue_bright(&command.location)
+            Logger::with_theme(|theme| theme.highlight(&command.location))
         );
         Logger::exit_with_info("Please rename one of these");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@repokit/core",
-  "version": "2.0.6",
+  "version": "2.1.0",
   "description": "A knowledgebase for your repository - wrapped in a CLI",
   "keywords": [
     "cli",
@@ -62,11 +62,11 @@
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-unused-imports": "^4.4.1",
-    "oxfmt": "^0.41.0",
+    "oxfmt": "^0.42.0",
     "oxlint": "^1.42.0",
-    "oxlint-tsgolint": "^0.17.0",
+    "oxlint-tsgolint": "^0.18.1",
     "tsdown": "^0.21.0",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.2"
   }
 }