Skip to content

README.md

Latest commit

 

History

History
90 lines (75 loc) · 3.57 KB

README.md

File metadata and controls

90 lines (75 loc) · 3.57 KB
EVP-Gear Logo

EVP-Gear

A modular, local-first web application designed for precise gear management and pack planning.

React TypeScript TailwindCSS Vite


EVP-Gear is an analytical, database-driven tool for backpackers, climbers, and photographers to obsessively track and analyze their equipment. Built for speed and privacy, it runs entirely in your browser using IndexedDB. EVP-Gear is Open Source and published under the GNU General Public License.

📸 The Interface

The Builder (Pack Page)
Assemble loadouts and analyze weight distribution via interactive Nivo pie charts.
Pack Page 		The Input Engine (Edit Page)
Rapidly add gear using the dynamic 3-tier tagging system and Zod-validated forms.
Edit Page
The Database (View Page)
Search and filter your entire local gear inventory instantly.
Database View 		PDF Export
Generate beautiful, checklist-style PDF reports of your assembled packs.
PDF Export

✨ Key Features

  • Strict 3-Tier Hierarchy: Organize gear by Top-Tag (e.g., Sleep), Middle-Tag (e.g., Sleeping Bags), and Base-Tag (e.g., 3-Season).
  • Local-First Architecture: Powered by Dexie.js (IndexedDB). Your data never leaves your browser. Fast, private, and works completely offline.
  • Advanced Analytics: Differentiates between Standard, Worn, and Consumable weights to give you accurate Base Weight calculations.
  • Adaptive Theming: Seamlessly switch between Dark, Light, and Nature themes (including dynamic browser favicons).
  • Mobile Optimized: The entire UI, including complex split-screen builders, is fully responsive for use on the trail.

🛠️ Tech Stack

  • Core: React 19, TypeScript, Vite
  • Styling: Tailwind CSS v4, Shadcn UI
  • State & Data: Zustand (global state), Dexie.js (IndexedDB wrapper)
  • Forms & Validation: React Hook Form, Zod
  • Visualization: Nivo Charts, React-PDF

🚀 Getting Started

To run EVP-Gear locally:

  1. Clone the repository: 
    git clone https://github.com/AlpineOpponent/EVP-Gear.git
  2. Navigate to the directory: 
    cd EVP-Gear
  3. Install dependencies: 
    npm install
  4. Start the development server: 
    npm run dev

🤝 Contributors

  • AlpineOpponent - Creator & Lead Developer
  • Gemini - AI Development Assistant

"Measure twice, pack once."