create-react-scaffold-cli 0.1.0

package/templates/base/src/shared/constants/app.constants.js

@@ -0,0 +1,4 @@
+export const ENV = {
+  BACKEND_URL: import.meta.env.VITE_BACKEND_URL,
+};
+

package/templates/base/src/shared/hooks/index.js

@@ -0,0 +1,3 @@
+export { useBooleanState } from './useBooleanState';
+export { useDebounce } from './useDebounce';
+export { useToggleState } from './useToggleState';

package/templates/base/src/shared/hooks/useBooleanState.js

@@ -0,0 +1,19 @@
+import React from 'react';
+
+export const useBooleanState = () => {
+  const [value, setValue] = React.useState(false);
+
+  const toggle = React.useCallback(() => {
+    setValue((v) => !v);
+  }, []);
+
+  const setToTrue = React.useCallback(() => {
+    setValue(true);
+  }, []);
+
+  const setToFalse = React.useCallback(() => {
+    setValue(false);
+  }, []);
+
+  return [value, setToTrue, setToFalse, toggle];
+};

package/templates/base/src/shared/hooks/useDebounce.js

@@ -0,0 +1,17 @@
+import React from 'react';
+
+export const useDebounce = (value, delay) => {
+  const [debounceValue, setDoebounceValue] = React.useState(value);
+
+  React.useEffect(() => {
+    const handler = setTimeout(() => {
+      setDoebounceValue(value);
+    }, delay);
+
+    return () => {
+      clearTimeout(handler);
+    };
+  }, [value, delay]);
+
+  return debounceValue;
+};

package/templates/base/src/shared/hooks/useToggleState.js

@@ -0,0 +1,11 @@
+import React from 'react';
+
+export const useToggleState = () => {
+  const [state, setState] = React.useState(false);
+
+  const toggle = React.useCallback(() => {
+    setState((v) => !v);
+  }, []);
+
+  return [state, toggle];
+};

package/templates/base/src/shared/libs/axios.js

@@ -0,0 +1,6 @@
+import baseAxios from 'axios';
+import { ENV } from '../constants/app.constants';
+
+export const axios = baseAxios.create({
+  baseURL: ENV.BACKEND_URL,
+});

package/templates/base/src/shared/libs/cn.js

@@ -0,0 +1,7 @@
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+export function cn(...inputs) {
+  return twMerge(clsx(...inputs));
+}
+    

package/templates/base/src/shared/libs/index.js

@@ -0,0 +1,2 @@
+export { axios } from './axios';
+export { cn } from './cn';

package/templates/base/src/shared/shared_readme.md

@@ -0,0 +1,98 @@
+# Shared Module
+
+## Purpose
+The `shared` folder contains **cross-feature reusable code**.
+
+It exists to prevent duplication — not to become a dumping ground.
+
+> Shared code must earn its place.
+
+---
+
+## What Belongs in Shared
+
+Only code that is:
+- Used by **multiple features**
+- **Stateless or generic**
+- Independent of business rules
+
+---
+
+## Folder Structure
+
+```txt
+shared/
+  assets/      # Global images/icons
+  constants/   # App-wide constants
+  contexts/    # Truly global contexts
+  hooks/       # Reusable generic hooks
+  layouts/     # Application layouts
+  libs/        # Third-party wrappers (axios, query)
+  theme/       # Theme configuration
+  ui/          # Design system components
+  utils/       # Pure utility functions
+```
+
+---
+
+## Rules
+
+### ✅ Allowed
+- UI primitives (Button, Modal)
+- Generic hooks (useDebounce)
+- Axios/query setup
+- Theme tokens
+
+### ❌ Not Allowed
+- Feature logic
+- Business rules
+- Feature-specific constants
+- Feature state
+
+---
+
+## Import Rules
+
+```js
+// ✅ Allowed
+import { axios } from '@/shared/libs';
+import { cn } from '@/shared/utils';
+
+// ❌ Not Allowed
+import { authQueryKeys } from '@/features/auth';
+```
+
+---
+
+## Constants Policy
+
+Shared constants should be:
+- Truly global
+- Stable
+- Rarely changed
+
+Examples:
+- Pagination defaults
+- Environment keys
+- Generic route params
+
+---
+
+## Contexts
+
+Global contexts should be rare.
+
+Before adding one, ask:
+1. Is this needed by multiple unrelated features?
+2. Can this live inside a feature instead?
+
+If unsure — **do not add it here**.
+
+---
+
+## Philosophy
+
+Shared code is a **dependency magnet**.
+
+The smaller it stays, the healthier the system remains.
+

package/templates/base/src/shared/theme/index.js

@@ -0,0 +1 @@
+export * from './theme';