@softfix/code-standards v1.0.0
@softfix/code-standards
š Enforce Consistent Code Standards Across Projects
This package ensures consistent naming conventions for files, functions, variables, and interfaces in React, Next.js, Node.js, and TypeScript projects.
š¦ Installation
npm install --save-dev @softfix/code-standards
š Usage
Run Pre-commit Checks Manually
npx softfix-precommit
This command performs the following checks:
- File Names: Must be lowercase and kebab-case (e.g.,
my-component.tsx
). - Functions: Must use camelCase (e.g.,
fetchData
). - Variables: Must use camelCase or UPPER_CASE.
- Interfaces: Must use PascalCase and start with
I
(e.g.,IUserProfile
).
ā If any rule is violated, the pre-commit will fail and show the list of issues.
š§© Examples
ā File Names
- Correct:
user-profile.ts
,order-list.component.tsx
- Incorrect:
UserProfile.ts
,order_list.tsx
ā Function Names
// ā
Correct
function getUserDetails() {}
// š« Incorrect
function GetUserDetails() {}
function get_user_details() {}
ā Variable Names
// ā
Correct
const userName = 'John';
const API_KEY = '12345';
// š« Incorrect
const UserName = 'John';
const apiKey = '12345';
ā Interface Names
// ā
Correct
interface IUser {
id: number;
name: string;
}
// š« Incorrect
interface user {
id: number;
name: string;
}
interface UserInterface {} // Should start with 'I'
š ļø Why Use This Package?
ā Automates code standard checks for faster development workflows ā Reduces code review time and improves code quality ā Seamlessly enforces company-wide coding standards ā Keeps naming conventions consistent across all projects ā Easily integrates with existing development pipelines and tools ā Prevents common naming mistakes before code is committed ā Saves time by catching issues early in the development cycle ā Enhances team collaboration through standardized code practices ā Provides clear, actionable feedback for quick fixes ā Supports scalable codebases by maintaining clean and organized code ā Works out of the box with minimal configuration ā Increases project maintainability and reduces technical debt
š» Keep your codebase clean, consistent, and error-free with @softfix/code-standards!
5 months ago