ng-postbuild

🛠️ A simple post-build CLI utility for Angular projects to flatten and clean up the dist/ output directory.

✨ Features

• Moves files from dist/<project>/browser/ to dist/<project>/
• Renames index.csr.html to index.html
• Removes the empty browser folder
• Automatically detects the default Angular project from angular.json

📦 Installation

🔧 As a Global CLI Tool (recommended for local or manual use)

npm install -g ng-postbuild

After building your Angular app, you can run it directly:

ng-postbuild

🛠️ As a Dev Dependency (recommended for automation or CI/CD)

npm install --save-dev ng-postbuild

Then add it to your package.json scripts:

{
  "scripts": {
    "build:dev": "ng build --base-href /test-project {optional} --configuration development && ng-postbuild --out {tar file name example - dist_test_project}",
    "build:prod": "ng build --base-href /test-project {optional} --configuration production && ng-postbuild  --out {tar file name example - dist_test_project}",
    "build:both": "npm run build:dev && npm run build:prod"
  }
}

Now simply run:

npm run build:dev (or :prod or :both)

⚙️ CLI Options

| Option | Description | Default | | ------------------- | ------------------------------------------------------------------------------ | ---------------------------------------------------- | | --out <filename> | Specify the name of the output .tar archive file. | <defaultProject>.tar | | --rename <folder> | Rename the project folder inside the archive (e.g., rename my-app folder). | Unchanged (original name from angular.json) | | --no-compress | Skip creating the .tar archive; only moves and cleans up files. | Compression enabled - Include dist/ folder | | --delete-server | Delete the "server" folder after build | Does not delete server folder from dist | | --help | Display help information and exit. | N/A |

📂 Example Workflow

ng build --configuration production
ng-postbuild --out build --rename my-app

Now your final deployment-ready files will be directly inside dist/project/.

📁 Output Before

dist/
└── my-project/
    └── browser/
        ├── main.js
        ├── styles.css
        └── index.csr.html

📁 Output After

dist/
└── my-project/
    ├── main.js
    ├── styles.css
    └── index.html

⚙️ Notes

Works with Angular CLI projects

Requires angular.json to be present in the root

Supports workspaces and monorepos by detecting defaultProject

📃 License

MIT

👨‍💻 Author

Sunil Solanki

Feel free to contribute, suggest improvements, or open issues on GitHub: ng-postbuild