Skip to main content

System Requirements

Before installing the Production Inspection Form application, ensure your system meets the following requirements:
This application is built with Next.js and designed for static export deployment.

Required Software

  • Node.js: Version 18.x or higher
  • Package Manager: npm, yarn, or pnpm
  • Web Server: Any HTTP server capable of serving static files (nginx, Apache, etc.)
  • Browser Support: Modern browsers with JavaScript enabled (Chrome, Firefox, Edge, Safari)

Backend Requirements

  • Access to the inspection API server at http://10.107.194.110/insp/
  • LDAP server for user authentication
  • Network connectivity between client browsers and the API server

Installation Steps

1
Download the Application
2
Obtain the Production Inspection Form source code from your repository or distribution package.
3
Install Dependencies
4
Navigate to the project directory and install the required Node.js dependencies:
5
npm
npm install
yarn
yarn install
pnpm
pnpm install
6
The application uses React 18+ and Next.js App Router architecture.
7
Verify Installation
8
Check that all dependencies are properly installed:
9
npm
npm list --depth=0
yarn
yarn list --depth=0
pnpm
pnpm list --depth=0

Key Dependencies

The application relies on the following core dependencies:
PackagePurpose
nextNext.js framework for React applications
reactCore React library for UI components
react-domReact DOM rendering
styled-jsxCSS-in-JS styling solution (included with Next.js)

Development Environment Setup

Running the Development Server

Start the Next.js development server for local testing:
npm run dev
The application will be available at http://localhost:3000.
In development mode, ensure you have network access to the API server at http://10.107.194.110/insp/ for full functionality.

Development Features

  • Hot Module Replacement: Automatic page refresh on code changes
  • Error Overlay: Development-time error reporting
  • Fast Refresh: Preserves component state during edits

Project Structure

The application follows Next.js App Router conventions:
production-inspection-form/
├── app/
│   ├── page.jsx              # Main inspection form
│   ├── login/
│   │   └── page.jsx          # Login page
│   ├── layout.jsx            # Root layout
│   └── globals.css           # Global styles
├── public/
│   ├── logo-goodyear.png     # Company logo
│   └── favicon.ico           # Site icon
├── next.config.js            # Next.js configuration
└── package.json              # Project dependencies

Troubleshooting Installation

Node Version Issues

If you encounter compatibility issues, verify your Node.js version:
node --version
Upgrade to Node.js 18.x or higher if needed.

Dependency Conflicts

Clear your package manager cache and reinstall:
rm -rf node_modules package-lock.json
npm cache clean --force
npm install

Network Access Issues

Ensure your development environment can reach http://10.107.194.110/insp/ before proceeding. The application requires this API endpoint for authentication and data submission.

Next Steps

After successful installation:
  1. Configure the application settings (see Configuration)
  2. Build and deploy the application (see Deployment)
  3. Test the login and inspection form functionality

Build docs developers (and LLMs) love