Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/codefend/core
Code obfuscator CLI that protects your code regardless of the programming language or framework.
https://github.com/codefend/core
angular arduino nuxt obfuscator python react svelte uglify vue
Last synced: 1 day ago
JSON representation
Code obfuscator CLI that protects your code regardless of the programming language or framework.
- Host: GitHub
- URL: https://github.com/codefend/core
- Owner: Codefend
- License: mit
- Created: 2023-01-03T17:35:58.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-01T05:50:21.000Z (17 days ago)
- Last Synced: 2024-11-15T05:54:13.897Z (3 days ago)
- Topics: angular, arduino, nuxt, obfuscator, python, react, svelte, uglify, vue
- Language: TypeScript
- Homepage: https://codefend.github.io/docs
- Size: 1.33 MB
- Stars: 17
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Codefend
![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/Codefend/core/ci.yml?branch=main)
![NPM](https://img.shields.io/npm/dt/codefend)
![Bundlephobia](https://img.shields.io/bundlephobia/min/codefend)
![NPM](https://img.shields.io/node/v/codefend)
![NPM](https://img.shields.io/npm/l/codefend)`Codefend` is a dynamic đĒŠ CLI tool that obfuscates your source code, folders, and file names, compatible with any programming language or framework.
It delivers powerful obfuscation while ensuring performance maintained âĄ, so you benefit from enhanced security without compromising your application's speed or efficiency.
Additionally, Codefend offers plugins for Webpack, Rollup, and Vite.Beyond simple obfuscation, Codefend delivers advanced features, integrating smoothly with current uglifiers or minifiers. It employs a two-layer obfuscation đĒ process, embedding hidden code within hidden code for irreversible source code protection.
For Codefend to work properly, you need to implement a folder and files naming convention, a code naming convention, or both. Once set up, Codefend will handle obfuscation, allowing you to concentrate on development and safeguard your intellectual property â¨
- [Folder and files naming convention](https://codefend.github.io/docs/basic-usage/naming-conventions/folders-files-naming-convention)
- [Code naming convention](https://codefend.github.io/docs/basic-usage/naming-conventions/code-naming-convention)Visit the [docs](https://codefend.github.io/docs/) for instructions, examples, and advanced settings.
## Installation
#### `Globally`
```bash
npm install -g codefend
codefend -i //required only the first time, generates .codefendrc.json
codefend -o //obfuscates your whole project inside a new directory: 'codefend-output'
```#### `Dev dependency`
```bash
npm install -D codefend
```#### `npx`
In case you want to execute it directly without installing it on your machine:
```bash
npx codefend -i //required only the first time, generates .codefendrc.json
npx codefend -o //obfuscates your whole project inside a new directory: 'codefend-output'
```#### `Webpack`
If you're using Webpack, you can use [webpack-plugin-codefend](https://www.npmjs.com/package/webpack-plugin-codefend) instead of directly using the CLI, keeping in mind that not all features are propagated to the plugin and may take time to become available.
#### `Rollup/Vite`
If you're using Rollup or Vite, you can use [rollup-plugin-codefend](https://www.npmjs.com/package/rollup-plugin-codefend) instead of directly using the CLI, keeping in mind that not all features are propagated to the plugin and may take time to become available.
## Commands
```shell
Usage: codefend [options]Defend Your Code By All Means Necessary. đĒ đ
Options:
-i, --init Create the config file (.codefendrc.json)
-o, --obfuscate Obfuscate the project
-c, --check Check the config file for potential warnings/errors
-v, --version Output the version number
-h, --help Display help for command
```## Basic Usage
### `Step 1`: Naming convention
`Add prefixes to the words that you want to encrypt.`
```js
//as a starting point: prefix the words that should be encrypted with l_
class l_Calculator {
l_sum(l_a, l_b) {
const l_results = l_a + l_b;
return l_results;
}
}//>>>>>>==== Will Become ======<<<<<<
class Ox0 {
Ox1(Ox2, Ox3) {
const Ox4 = Ox2 + Ox3;
return Ox4;
}
}// Or for a better organized naming convention:
/**
*
1- class -> starts with c_
2- function -> starts with f_
3- parameter -> starts with p_
4- local variable -> starts with l_
*/
class c_Calculator {
f_sum(p_a, p_b) {
const l_results = p_a + p_b;
return l_results;
}
}//>>>>>>==== Same results ======<<<<<<
class Ox0 {
Ox1(Ox2, Ox3) {
const Ox4 = Ox2 + Ox3;
return Ox4;
}
}
``````html
.l_red {
color: red;
}
l_secret
Hello World
.Ox1 {
color: red;
}
Ox0
Hello World
```
### `Step 2`: Run the CLI
`navigate to the root of your project and run the following commands:`
```bash
codefend -i //required only the first time, generates .codefendrc.json```
```bash
codefend -o //obfuscates your whole project inside a new directory: 'codefend-output'
```For a more detailed explanation, please refer to the [obfuscation](https://codefend.github.io/docs/basic-usage/obfuscation) section of the docs.
### `Step 3`: install dependencies, build and deploy the obfuscated project
Please refer to the [build and deployment](https://codefend.github.io/docs/distribution/build-and-deployment) and [ troubleshooting](https://codefend.github.io/docs/distribution/troubleshooting) sections of the docs.
## Configuration
Please refer to the [configuration](https://codefend.github.io/docs/references/configuration) section of the docs.
## Migration guide
Please refer to the [migration guide](https://codefend.github.io/docs/migrations/codefend-v3) section of the docs.
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
## License
[MIT](./LICENSE.md)