IP Calculator

A comprehensive IP subnet calculator and Infrastructure-as-Code (IaC) generator with both web interface and command-line interface (CLI) support for multiple cloud providers.

Features

Web Interface

Multi-Cloud Support: Azure, AWS, GCP, Oracle Cloud, Alibaba Cloud, and On-Premises
Visual IP Calculation: Real-time subnet calculations with detailed network information
IaC Code Generation: Generate ready-to-use Infrastructure-as-Code templates
- Azure: CLI, Terraform, Bicep, ARM, PowerShell
- AWS: CLI, Terraform, CloudFormation
- GCP: gcloud CLI, Terraform
- Oracle: OCI CLI, Terraform
- Alibaba Cloud: Aliyun CLI, Terraform
Binary View: Display IP addresses in binary format (collapsible)
Responsive UI: Modern, clean interface built with Vue.js and Vuetify
Cloud-Specific Calculations: Respects reserved IPs and subnet size limits for each cloud provider

Command-Line Interface (CLI)

Automated Testing: Generate IaC code for CI/CD pipelines
Batch Processing: Create infrastructure code for multiple environments
File Output: Save generated code directly to files
Scriptable: Perfect for automation and testing workflows

Technology Stack

Vue.js 3 - Progressive JavaScript framework
TypeScript - Type-safe JavaScript
Vite - Fast build tool and development server
Vuetify - Material Design component framework
NGINX - Production web server
tsx - TypeScript execution engine for CLI

Getting Started

Prerequisites

Node.js 18 or higher
npm or yarn
NGINX (for production deployment)

Installation

Clone the repository:

git clone <repository-url>
cd ipcalc

Install dependencies:

npm install

Web Interface Usage

Development

Start the development server:

npm run dev

Open your browser at http://localhost:5173 (or the port shown in terminal)

Production Build

Build the application for production:

npm run build

The built files will be in the dist/ directory.

Using the Web Interface

Select Cloud Provider: Choose from Azure, AWS, GCP, Oracle, Alibaba Cloud, or On-Premises
Enter Network CIDR: Input your network address (e.g., 10.0.0.0/16)
Set Number of Subnets: Specify how many subnets to create (1-256)
View Results: See detailed subnet information including:
- Network addresses
- Subnet masks
- Total and usable IP counts
- Reserved IPs
- Usable IP ranges
- Availability zones/regions
Generate Code: Click on CLI, Terraform, or other format buttons to generate IaC code
Copy Code: Use the copy button to copy generated code to clipboard

CLI Usage

Quick Start

npm run cli -- --help

Basic Commands

Show Network Information

Display detailed subnet calculations:

# Azure
npm run cli -- --provider azure --cidr 10.0.0.0/16 --subnets 4

# AWS
npm run cli -- --provider aws --cidr 10.0.0.0/16 --subnets 3

# GCP
npm run cli -- --provider gcp --cidr 10.128.0.0/20 --subnets 2

Generate Terraform Code

# Azure Terraform
npm run cli -- --provider azure --cidr 10.0.0.0/16 --subnets 2 --output terraform

# AWS Terraform
npm run cli -- --provider aws --cidr 10.0.0.0/16 --subnets 3 --output terraform

# GCP Terraform
npm run cli -- --provider gcp --cidr 10.128.0.0/20 --subnets 2 --output terraform

Generate Cloud CLI Scripts

# Azure CLI script
npm run cli -- --provider azure --cidr 10.0.0.0/16 --subnets 2 --output cli --file azure-deploy.sh

# AWS CLI script
npm run cli -- --provider aws --cidr 10.0.0.0/16 --subnets 3 --output cli --file aws-deploy.sh

# GCP gcloud script
npm run cli -- --provider gcp --cidr 10.128.0.0/20 --subnets 2 --output gcloud --file gcp-deploy.sh

# Oracle OCI CLI script
npm run cli -- --provider oracle --cidr 10.0.0.0/20 --subnets 4 --output oci --file oracle-deploy.sh

# AliCloud Aliyun CLI script
npm run cli -- --provider alicloud --cidr 172.16.0.0/12 --subnets 3 --output aliyun --file alicloud-deploy.sh

Generate Other IaC Formats

# Azure Bicep
npm run cli -- --provider azure --cidr 10.0.0.0/16 --subnets 2 --output bicep --file main.bicep

# Azure ARM Template
npm run cli -- --provider azure --cidr 10.0.0.0/16 --subnets 2 --output arm --file template.json

# Azure PowerShell
npm run cli -- --provider azure --cidr 10.0.0.0/16 --subnets 2 --output powershell --file deploy.ps1

# AWS CloudFormation
npm run cli -- --provider aws --cidr 10.0.0.0/16 --subnets 3 --output cloudformation --file stack.yaml

CLI Arguments

Required

--provider <name> - Cloud provider: azure, aws, gcp, oracle, alicloud, onpremises
--cidr <cidr> - Network CIDR notation (e.g., 10.0.0.0/16)
--subnets <count> - Number of subnets to create (1-256)

Optional

--output <type> - Output format (default: info)
--file <path> - Write output to file instead of stdout
--help - Show help message

CLI Use Cases

1. Testing and Validation

Generate IaC code and validate before deployment:

npm run cli -- --provider aws --cidr 10.0.0.0/16 --subnets 3 --output terraform --file test.tf
terraform validate test.tf

2. CI/CD Pipeline Integration

#!/bin/bash
# Generate infrastructure for different environments
for env in dev staging prod; do
  npm run cli -- \
    --provider aws \
    --cidr 10.${env}.0.0/16 \
    --subnets 3 \
    --output terraform \
    --file ${env}-infrastructure.tf
done

3. Documentation Generation

# Generate network documentation for all providers
npm run cli -- --provider azure --cidr 10.0.0.0/16 --subnets 4 > docs/azure-network.txt
npm run cli -- --provider aws --cidr 10.0.0.0/16 --subnets 3 > docs/aws-network.txt

4. Multi-Cloud Comparison

# Compare subnet allocations across different cloud providers
for provider in azure aws gcp oracle alicloud; do
  echo "=== $provider ===" >> comparison.txt
  npm run cli -- --provider $provider --cidr 10.0.0.0/16 --subnets 4 >> comparison.txt
done

For more detailed CLI documentation, see CLI.md.

Cloud Provider Details

Azure

Reserved IPs: 5 per subnet (first 4 + last 1)
Minimum Subnet: /29 (8 IPs, 3 usable)
VNet CIDR Range: /8 to /29
Outputs: CLI, Terraform, Bicep, ARM, PowerShell

AWS

Reserved IPs: 5 per subnet (first 4 + last 1)
Minimum Subnet: /28 (16 IPs, 11 usable)
VPC CIDR Range: /16 to /28
Availability Zones: Subnets distributed across AZs
Outputs: CLI, Terraform, CloudFormation

Google Cloud Platform (GCP)

Reserved IPs: 4 per subnet (first 2 + last 2)
Minimum Subnet: /29 (8 IPs, 4 usable)
VPC: Global (subnets are regional)
Outputs: gcloud CLI, Terraform

Oracle Cloud

Reserved IPs: 3 per subnet (first 2 + last 1)
Minimum Subnet: /30 (4 IPs, 1 usable)
VCN CIDR Range: /16 to /30
Outputs: OCI CLI, Terraform

Alibaba Cloud

Reserved IPs: 6 per subnet (first 3 + last 3)
Minimum Subnet: /29 (8 IPs, 2 usable)
VPC CIDR Range: /8 to /29
Outputs: Aliyun CLI, Terraform

On-Premises

Reserved IPs: 2 (network address + broadcast)
Standard IP Calculations: Classic subnet calculations
Outputs: Network information only

Deployment

Local NGINX Deployment

Build the application:

npm run build

Copy the built files to your NGINX web root:

sudo cp -r dist/* /usr/share/nginx/html/

Copy the NGINX configuration:

sudo cp nginx.conf /etc/nginx/conf.d/ipcalc.conf

Restart NGINX:

sudo systemctl restart nginx

Access the application at http://localhost

Docker Deployment

Create a Dockerfile:

FROM node:18 AS build
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build

FROM nginx:alpine
COPY --from=build /app/dist /usr/share/nginx/html
COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

Build and run:

docker build -t ipcalc .
docker run -p 80:80 ipcalc

Project Structure

ipcalc/
├── src/
│   ├── cli/
│   │   ├── index.ts              # CLI entry point
│   │   ├── ipCalculator.ts       # Core IP calculation logic
│   │   └── templateLoaderNode.ts # Node.js template loader
│   ├── components/
│   │   ├── AzureCalculator.vue   # Azure calculator component
│   │   ├── AwsCalculator.vue     # AWS calculator component
│   │   ├── GcpCalculator.vue     # GCP calculator component
│   │   ├── OracleCalculator.vue  # Oracle calculator component
│   │   ├── AliCloudCalculator.vue # AliCloud calculator component
│   │   └── OnPremisesCalculator.vue # On-Premises calculator
│   ├── config/
│   │   ├── cloudProviderConfig.ts # Cloud provider configurations
│   │   └── cloudThemes.ts        # UI themes for each provider
│   ├── templates/
│   │   ├── azure/                # Azure IaC templates
│   │   ├── aws/                  # AWS IaC templates
│   │   ├── gcp/                  # GCP IaC templates
│   │   ├── oracle/               # Oracle IaC templates
│   │   └── alicloud/             # AliCloud IaC templates
│   ├── utils/
│   │   └── templateLoader.ts     # Template loader for web UI
│   ├── App.vue                   # Main application component
│   └── main.ts                   # Application entry point
├── bin/
│   └── ipcalc.js                 # CLI executable wrapper
├── dist/                         # Production build output
├── index.html                    # HTML entry point
├── nginx.conf                    # NGINX configuration
├── package.json                  # Project dependencies
├── tsconfig.json                 # TypeScript configuration
├── vite.config.ts                # Vite build configuration
├── README.md                     # This file
└── CLI.md                        # Detailed CLI documentation

Scripts

npm run dev - Start development server
npm run build - Build for production
npm run preview - Preview production build locally
npm run typecheck - Run TypeScript type checking
npm run cli - Run CLI tool (add -- --help for CLI help)

Development

Adding a New Cloud Provider

Add configuration to src/config/cloudProviderConfig.ts
Add theme to src/config/cloudThemes.ts
Create Vue component in src/components/
Create template directory in src/templates/
Add template loader functions to src/utils/templateLoader.ts (for web UI)
Add template loader functions to src/cli/templateLoaderNode.ts (for CLI)
Update CLI in src/cli/index.ts to support the new provider

Running Tests

# Test CLI with all providers
for provider in azure aws gcp oracle alicloud; do
  npm run cli -- --provider $provider --cidr 10.0.0.0/16 --subnets 2
done

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Support

For detailed CLI documentation, see CLI.md.

For issues and feature requests, please open an issue on GitHub.

Name		Name	Last commit message	Last commit date
Latest commit History 77 Commits
.github/workflows		.github/workflows
bin		bin
docs		docs
src		src
.gitignore		.gitignore
README.md		README.md
index.html		index.html
jsrepo.json		jsrepo.json
nginx.conf		nginx.conf
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts

jvhoof/ipcalc

Folders and files

Latest commit

History

Repository files navigation

IP Calculator

Features

Web Interface

Command-Line Interface (CLI)

Technology Stack

Getting Started

Prerequisites

Installation

Web Interface Usage

Development

Production Build

Using the Web Interface

CLI Usage

Quick Start

Basic Commands

Show Network Information

Generate Terraform Code

Generate Cloud CLI Scripts

Generate Other IaC Formats

CLI Arguments

Required

Optional

CLI Use Cases

1. Testing and Validation

2. CI/CD Pipeline Integration

3. Documentation Generation

4. Multi-Cloud Comparison

Cloud Provider Details

Azure

AWS

Google Cloud Platform (GCP)

Oracle Cloud

Alibaba Cloud

On-Premises

Deployment

Local NGINX Deployment

Docker Deployment

Project Structure

Scripts

Development

Adding a New Cloud Provider

Running Tests

Contributing

License

Support

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors 2

Uh oh!

Languages

Packages