Skip to content

Latest commit

Β 

History

60 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

PNG Civil Engineering CAD Software

A free, browser-based CAD application for Civil Engineers in Papua New Guinea πŸ‡΅πŸ‡¬

Tests Version License

No installation required β€’ Works on any device β€’ 100% free


🎯 What is This?

PNG Civil CAD is a free CAD tool designed specifically for civil engineers working in Papua New Guinea. Unlike expensive commercial software, this is:

  • Free - No license fees, ever
  • Browser-based - Works on any computer with a web browser
  • PNG-specific - Built-in data for all 22 provinces

Who is it for?

  • Civil engineers in PNG
  • Drafters and technicians
  • Engineering students
  • Anyone doing construction design in PNG

✨ Key Features

CAD Tools (17 Total)

Drawing Modify Annotation
Line Trim Text
Circle Extend Dimension
Rectangle Offset Measure
Polyline Mirror Hatch
Arc Rotate
Polygon Scale
Array

PNG-Specific Features

  • 22 Provinces - Seismic zones, climate data, flood risk for every province
  • Structural Calculations - Beam, column, footing sizing for PNG conditions
  • Material Costs - Prices in PNG Kina
  • Construction Sequences - Step-by-step builder guidance
  • Design Validation - Code compliance checking

Professional Features

  • DXF Import/Export - Works with AutoCAD files
  • Project Explorer - See all objects organized by layer
  • Keyboard Shortcuts - Press ? for full list
  • Feedback System - Built-in bug reporting

πŸš€ Get Started

Option 1: Use Online (Recommended) 🌐

Just open the link and start designing β€” no installation needed!

βœ… Works on any device (Windows, Mac, Linux, tablets)
βœ… No downloads or setup
βœ… Always up-to-date
βœ… 100% free


Option 2: Run Locally (For Developers)

If you want to modify the code or run it offline:

Requirements:

Installation:

# Clone the repository
git clone https://github.com/BruinGrowly/PNG-AutoCad-Software.git

# Go into the folder
cd PNG-AutoCad-Software

# Install dependencies
npm install

# Start the app
npm run dev

Then open http://localhost:5173 in your browser.

πŸ“– First time using Git? See docs/QUICK_START_GUIDE.md for step-by-step instructions.


Option 3: Deploy Your Own Copy

Deploy to Netlify

Want your own deployment? Click the button above or see docs/DEPLOYMENT.md for detailed instructions.


πŸ“š Documentation

Document Description
Quick Start Guide Installation & basic usage
Deployment Guide Deploy to Netlify
User Manual Complete user guide (630+ lines)
Legal Disclaimers & liability
Data Sources Where our data comes from

πŸ§ͺ Testing

npm test           # Watch mode
npm run test:run   # Single run
npm run test:coverage
npm run verify     # Tests + production build

529 tests covering all modules.


πŸ“ Project Structure

src/
β”œβ”€β”€ core/                 # CAD Engine
β”‚   β”œβ”€β”€ engine.js         # Project, layer, entity management
β”‚   β”œβ”€β”€ geometry.js       # Geometric calculations
β”‚   β”œβ”€β”€ dimensions.js     # Measurement and annotation
β”‚   β”œβ”€β”€ blocks.js         # Reusable symbols
β”‚   └── dxf.js            # AutoCAD DXF export/import
β”‚
β”œβ”€β”€ png/                  # PNG Engineering Modules
β”‚   β”œβ”€β”€ provinces.js      # All 22 provinces
β”‚   β”œβ”€β”€ seismic.js        # Seismic analysis
β”‚   β”œβ”€β”€ climate.js        # Climate zones
β”‚   β”œβ”€β”€ flood.js          # Flood risk assessment
β”‚   β”œβ”€β”€ materials.js      # PNG materials database
β”‚   β”œβ”€β”€ structural.js     # Structural calculations
β”‚   └── constructionSequence.js  # Builder guidance
β”‚
└── ui/                   # User Interface (React)
    β”œβ”€β”€ App.jsx           # Main application
    β”œβ”€β”€ components/       # UI components
    └── store/            # State management

πŸ”§ Recent Changes (v2.0)

New Features

  • βœ… 17 CAD Tools - All drawing and modify tools now working
  • βœ… Project Explorer - Press E to see all objects
  • βœ… Keyboard Shortcuts - Press ? for help overlay
  • βœ… Context Menu - Right-click for quick actions
  • βœ… Feedback System - Click πŸ“£ to report bugs
  • βœ… Construction Sequences - Step-by-step builder guidance
  • βœ… Enhanced Status Bar - Entity count, quick toggles

PNG Data

  • βœ… All 22 provinces with seismic zones
  • βœ… Climate data (rainfall, temperature, cyclone risk)
  • βœ… Flood risk assessment
  • βœ… Material costs in Kina

Technical

  • βœ… 529 passing tests
  • βœ… DXF import/export
  • βœ… Offline capability
  • βœ… Auto-save

πŸ“Š PNG Data Coverage

Seismic Hazard (475-year return period)

Zone Hazard Factor Provinces
4 0.45 - 0.55 East New Britain, Madang, Morobe
3 0.35 - 0.40 Central, Milne Bay, Oro
2 0.28 - 0.30 Highlands provinces
1 0.15 Western

Wind Regions

Region Description Design Speed
A Non-cyclonic (Highlands) 41 m/s
B Intermediate (South coast) 50 m/s
C Cyclonic (North coast) 60 m/s
D Severe cyclonic (Islands) 67 m/s

⚠️ Important Disclaimer

This software provides calculations as a GUIDE ONLY. All designs must be verified and certified by a licensed Professional Engineer before construction. See LEGAL.md for full details.


πŸ“£ Feedback & Support

Found a bug? Have a suggestion?

  1. Click the πŸ“£ button in the app (bottom-right)
  2. Or email: bruinnecessities@gmail.com

πŸ“œ Standards Referenced

  • AS/NZS 1170.4 - Earthquake actions
  • AS/NZS 1170.2 - Wind actions
  • AS 2870 - Residential slabs and footings
  • AS 3600 - Concrete structures
  • ReCAP Rural Road Notes - Low-volume road design

🌐 Browser Support

Chrome 90+, Firefox 88+, Safari 14+, Edge 90+


πŸ“„ License

MIT License - Free to use, modify, and distribute.


Made with ❀️ for Papua New Guinea πŸ‡΅πŸ‡¬

GitHub β€’ Report Bug β€’ Request Feature

About

AutoCad Software Designed and Built for Papua New Guinea Conditions

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages