GitHub - cdavisv/getcampwood: A location finder app for finding local wood for where you're camping

Get Campwood

A microservice-based firewood finder that helps users locate, post, and manage firewood listings for camping or home use. Users can manage accounts, search via interactive maps, and perform CRUD operations on firewood locations.
Report Bug · Request Feature

About The Project

Get Campwood is a distributed Node.js application built with a microservices architecture. It allows users to find and share firewood locations through an interactive map interface. Users can create accounts, post firewood listings with GPS coordinates, search by address, and manage their listings.

The application consists of five independent services that communicate over REST APIs:

Service	Description	Port
Backend API	Main API server handling authentication, user management, and location CRUD operations	`5000`
Frontend	React single-page application providing the user interface	`5173`
Locations Service	Standalone microservice for firewood location CRUD operations with its own data model	`5001`
Geolocation Service	Geocoding and reverse geocoding via OpenStreetMap Nominatim, plus IP-based location detection	`5002`
Map UI Service	Standalone Leaflet-based map interface with CSP-safe tile proxying and security headers	`5174`

(back to top)

Architecture

                    ┌──────────────────┐
                    │   Frontend       │
                    │  React + Vite    │
                    │  Port: 5173      │
                    └────────┬─────────┘
                             │
                    ┌────────▼─────────┐
                    │   Backend API    │
                    │  Express + Mongo │
                    │  Port: 5000      │
                    └────────┬─────────┘
                             │
          ┌──────────────────┼──────────────────┐
          │                  │                  │
┌─────────▼────────┐ ┌──────▼──────────┐ ┌─────▼──────────┐
│ Locations Service│ │ Geolocation Svc │ │   Map UI Svc   │
│ Express + Mongo  │ │    Express      │ │ Express+Leaflet│
│ Port: 5001       │ │ Port: 5002      │ │ Port: 5174     │
└──────────────────┘ └─────────────────┘ └────────────────┘

Frontend communicates with the Backend API for authentication, user management, and location data.
Frontend calls the Geolocation Service directly for address search and IP-based location.
Map UI Service is a standalone map interface that consumes the Locations Service and Geolocation Service APIs.
All services share the same MongoDB database and JWT secret for consistent authentication.

(back to top)

Built With

Runtime: Node.js (v18+)
Backend Framework: Express.js
Frontend: React 18 + Vite
Database: MongoDB (via Mongoose)
Authentication: JSON Web Tokens (JWT) + bcryptjs
Maps: Leaflet.js
Icons: Lucide React
Security: Helmet.js (CSP headers)
Logging: Morgan
Validation: express-validator

(back to top)

Getting Started

Prerequisites

Node.js version 18 or higher
npm (comes with Node.js)
MongoDB — either a local MongoDB Community Edition instance or a MongoDB Atlas cloud connection string

Verify your Node.js installation:

node -v
npm -v

Project Structure

getcampwood/
├── backend/                    # Main API server (auth, users, locations)
│   ├── config/
│   │   └── database.js         # MongoDB connection setup
│   ├── middleware/
│   │   └── auth.js             # JWT authentication middleware
│   ├── models/
│   │   ├── User.js             # User data model
│   │   └── Location.js         # Firewood location data model
│   ├── routes/
│   │   ├── auth.js             # Registration, login, logout endpoints
│   │   ├── user.js             # Profile management, account deletion
│   │   └── Locations.js        # Location CRUD + proximity search
│   ├── server.js               # Express app entry point
│   ├── .env.example            # Environment variable template
│   └── package.json
│
├── frontend/
│   └── getcampwood/            # React + Vite SPA
│       ├── src/
│       │   ├── components/
│       │   │   ├── GetCampWoodHomepage.jsx  # Landing page
│       │   │   ├── LoginPage.jsx           # User login
│       │   │   ├── RegistrationPage.jsx    # User registration
│       │   │   ├── AccountPage.jsx         # Profile & listing management
│       │   │   ├── MapPage.jsx             # Interactive map with markers
│       │   │   ├── Header.jsx              # Navigation header
│       │   │   ├── Footer.jsx              # Page footer
│       │   │   └── MapPage.css             # Map page styles
│       │   ├── services/
│       │   │   └── api.js                  # API client service
│       │   ├── App.jsx                     # Main router & auth state
│       │   ├── App.css                     # App styles
│       │   ├── main.jsx                    # React entry point
│       │   └── index.css                   # Global styles
│       ├── public/                         # Static assets (logos, banner)
│       ├── vite.config.js                  # Vite build configuration
│       └── package.json
│
├── locations-service/          # Firewood locations CRUD microservice
│   ├── middleware/
│   │   └── auth.js             # JWT authentication
│   ├── models/
│   │   └── FirewoodLocation.js # Firewood location model
│   ├── server.js               # Express app with inline routes
│   ├── .env.example
│   └── package.json
│
├── geolocation-service/        # Geocoding microservice
│   ├── server.js               # Geocode, reverse geocode, IP location
│   ├── .env.example
│   └── package.json
│
├── map-ui/                     # Standalone map UI microservice
│   ├── public/
│   │   ├── index.html          # Map HTML page
│   │   └── app.js              # Map client-side JavaScript
│   ├── server.js               # Express app with CSP, tile proxy
│   ├── .env.example
│   └── package.json
│
├── .gitignore
├── LICENSE.md
└── README.md

Installation

Clone the repository

git clone https://github.com/cdavisv/getcampwood.git
cd getcampwood

Install dependencies for each service

# Backend API
cd backend
npm install

# Frontend
cd ../frontend/getcampwood
npm install

# Locations Service
cd ../../locations-service
npm install

# Geolocation Service
cd ../geolocation-service
npm install

# Map UI Service
cd ../map-ui
npm install

Environment Configuration

Each service that needs configuration has a .env.example file. Copy it to .env and fill in your values:

cp backend/.env.example backend/.env
cp locations-service/.env.example locations-service/.env
cp geolocation-service/.env.example geolocation-service/.env
cp map-ui/.env.example map-ui/.env

Backend (`backend/.env`)

Variable	Required	Default	Description
`MONGODB_URI`	Yes	—	MongoDB connection string (e.g., `mongodb+srv://user:pass@cluster.mongodb.net/dbname`)
`JWT_SECRET`	Yes	—	Secret key for signing JWT tokens. Use a long random string.
`PORT`	No	`5000`	Port the backend API listens on
`NODE_ENV`	No	`development`	Environment mode (`development` or `production`)

Locations Service (`locations-service/.env`)

Variable	Required	Default	Description
`MONGODB_URI`	Yes	—	MongoDB connection string (should be the same as the backend)
`JWT_SECRET`	Yes	—	JWT secret (must match the backend for shared authentication)
`PORT`	No	`5001`	Port the locations service listens on
`MONGODB_DB`	No	`getcampwood`	MongoDB database name

Geolocation Service (`geolocation-service/.env`)

Variable	Required	Default	Description
`PORT`	No	`5002`	Port the geolocation service listens on
`IP_GEO_URL`	No	`https://ipapi.co/json/`	URL for IP-based geolocation API

Map UI Service (`map-ui/.env`)

Variable	Required	Default	Description
`PORT`	No	`5174`	Port the map UI service listens on
`GEO_URL`	No	`http://localhost:5002/api`	Geolocation service URL
`LOC_URL`	No	`http://localhost:5001/api`	Locations service URL

Frontend

The frontend uses Vite environment variables (prefixed with VITE_). These can be set in frontend/getcampwood/.env:

Variable	Required	Default	Description
`VITE_API_URL`	No	`http://localhost:5000/api`	Backend API base URL

Running the Services

Run each service in its own terminal window:

# Terminal 1: Backend API
cd backend
npm run dev          # http://localhost:5000

# Terminal 2: Frontend
cd frontend/getcampwood
npm run dev          # http://localhost:5173

# Terminal 3: Locations Service
cd locations-service
npm run dev          # http://localhost:5001

# Terminal 4: Geolocation Service
cd geolocation-service
npm start            # http://localhost:5002

# Terminal 5: Map UI Service
cd map-ui
npm start            # http://localhost:5174

Note: The backend and frontend are the core services. The other microservices provide supplementary functionality (standalone map, geocoding, separate locations API).

(back to top)

API Documentation

Backend API (Port 5000)

Authentication

Method	Endpoint	Auth	Description
`POST`	`/api/auth/register`	Public	Register a new user. Body: `{ name, email, password }`
`POST`	`/api/auth/login`	Public	Login. Body: `{ email, password }`. Returns JWT token.
`GET`	`/api/auth/me`	Bearer	Get current authenticated user
`POST`	`/api/auth/logout`	Bearer	Logout (server acknowledgement; client removes token)

User Management

Method	Endpoint	Auth	Description
`PUT`	`/api/user/profile`	Bearer	Update profile. Body: `{ name, email, currentPassword?, newPassword? }`
`DELETE`	`/api/user/account`	Bearer	Delete account and all associated locations
`GET`	`/api/user/stats`	Bearer	Get user stats (total/active/pending location counts)

Locations

Method	Endpoint	Auth	Description
`GET`	`/api/locations`	Public	List active locations. Query params: `lat`, `lng`, `radius` (km), `limit` (max 100, default 50)
`GET`	`/api/locations/:id`	Public	Get a single active location by ID
`POST`	`/api/locations`	Bearer	Create a location. Body: `{ name, description?, price?, latitude, longitude }`. Rejects duplicates within ~100m.
`PUT`	`/api/locations/:id`	Bearer	Update a location (owner or admin only). Body: any subset of `{ name, description, price, latitude, longitude }`
`DELETE`	`/api/locations/:id`	Bearer	Delete a location (owner or admin only)
`GET`	`/api/locations/user/mine`	Bearer	Get current user's locations

System

Method	Endpoint	Auth	Description
`GET`	`/api/health`	Public	Health check — returns service status and timestamp
`GET`	`/api/test-db`	Public	Database connection status

Locations Service (Port 5001)

This is a standalone microservice with a simplified firewood location model.

Method	Endpoint	Auth	Description
`GET`	`/api/health`	Public	Health check
`GET`	`/api/locations`	Public	List all locations (newest first)
`GET`	`/api/locations/:id`	Public	Get a single location by ID
`POST`	`/api/locations`	Bearer	Create a location. Body: `{ name, description?, latitude, longitude }`
`PUT`	`/api/locations/:id`	Bearer	Update a location (owner or admin only)
`DELETE`	`/api/locations/:id`	Bearer	Delete a location (owner or admin only)

Geolocation Service (Port 5002)

All endpoints are public. Uses OpenStreetMap Nominatim for geocoding.

Method	Endpoint	Description
`GET`	`/api/geocode?q=<address>`	Forward geocode — converts address text to `{ lat, lon, label }`
`GET`	`/api/reverse?lat=<lat>&lon=<lon>`	Reverse geocode — converts coordinates to `{ label, lat, lon }`
`GET`	`/api/me`	IP-based geolocation — returns `{ lat, lon, city, region }`

Map UI Service (Port 5174)

A standalone map interface served as static HTML/JS with an Express backend for configuration and tile proxying.

Method	Endpoint	Description
`GET`	`/config.js`	Returns runtime configuration (geolocation and locations API URLs) as JavaScript
`GET`	`/vendor/leaflet/*`	Serves Leaflet library assets from node_modules
`GET`	`/tiles/:z/:x/:y.png`	Proxies OpenStreetMap tiles (CSP-compliant same-origin access)
`GET`	`/*`	Serves the static map UI (SPA fallback)

(back to top)

Database Schemas

All services connect to the same MongoDB instance.

User (`backend/models/User.js`)

Field	Type	Constraints	Description
`name`	String	Required, 2-50 chars	User's display name
`email`	String	Required, unique, validated	User's email address
`password`	String	Required, min 6 chars, hashed (bcrypt, cost 12)	User's password (excluded from queries by default)
`role`	String	Enum: `user`, `admin`. Default: `user`	User role for authorization
`isActive`	Boolean	Default: `true`	Whether the account is active
`lastLogin`	Date	—	Timestamp of last login
`createdAt`	Date	Auto	Account creation timestamp
`updatedAt`	Date	Auto	Last update timestamp

Location (`backend/models/Location.js`)

Field	Type	Constraints	Description
`name`	String	Required, 1-100 chars	Location name
`description`	String	Max 500 chars	Location description
`price`	Number	Min 0	Price per bundle/cord
`latitude`	Number	Required, -90 to 90	GPS latitude
`longitude`	Number	Required, -180 to 180	GPS longitude
`createdBy`	ObjectId	Required, ref: User	User who created this location
`status`	String	Enum: `active`, `pending`, `rejected`. Default: `active`	Moderation status
`verified`	Boolean	Default: `false`	Whether the location has been verified
`reportCount`	Number	Default: `0`	Number of reports against this location
`createdAt`	Date	Auto	Creation timestamp
`updatedAt`	Date	Auto	Last update timestamp

Indexes: Geospatial index on lat/lng, text index on name + description.

FirewoodLocation (`locations-service/models/FirewoodLocation.js`)

Field	Type	Constraints	Description
`name`	String	Required	Location name
`description`	String	—	Location description
`latitude`	Number	Required	GPS latitude
`longitude`	Number	Required	GPS longitude
`addedBy`	String	—	User email or ID of the creator
`createdAt`	Date	Auto	Creation timestamp
`updatedAt`	Date	Auto	Last update timestamp

(back to top)

Authentication

The application uses JSON Web Tokens (JWT) for authentication:

Registration/Login — The backend creates a JWT signed with JWT_SECRET containing the user's ID. The token expires after 7 days.
Token Storage — The frontend stores the token in localStorage and includes it in API requests as a Bearer token in the Authorization header.
Middleware — Protected endpoints use authentication middleware that verifies the JWT, looks up the user in the database, and confirms the account is active.
Authorization — Location update/delete operations check that the requesting user is either the owner of the location or has an admin role.
Cross-Tab Sync — The frontend listens for storage events to synchronize auth state across browser tabs.

Important: The JWT_SECRET must be the same across all services that verify tokens (backend and locations-service) so that tokens are interchangeable.

(back to top)

Usage

Once all services are running:

Visit http://localhost:5173 in your browser
Create an account using the registration page
Log in with your credentials
View the map to see existing firewood locations
Click on the map to add a new firewood listing (or use the + button)
Search by address using the search bar on the map page
Use "My Location" to center the map on your current position
Manage your listings from the Account page
Delete your own listings by clicking on a marker and using the delete button

(back to top)

Roadmap

See the open issues for more.

(back to top)

Contributing

Contributions are welcome!

Fork the project
Create your feature branch (git checkout -b feature/my-feature)
Commit your changes (git commit -m "Added my feature")
Push to your branch (git push origin feature/my-feature)
Open a Pull Request

(back to top)

License

Distributed under a custom proprietary "Look but Do Not Touch" License. See LICENSE.md for details.

Contact

Charles Davis

Project Link: https://github.com/cdavisv/getcampwood

(back to top)

Name		Name	Last commit message	Last commit date
Latest commit History 14 Commits
backend		backend
frontend		frontend
geolocation-service		geolocation-service
locations-service		locations-service
map-ui		map-ui
.gitignore		.gitignore
License.md		License.md
README.md		README.md
package-lock.json		package-lock.json

Folders and files

Latest commit

History

Repository files navigation

Get Campwood

Table of Contents

About The Project

Architecture

Built With

Getting Started

Prerequisites

Project Structure

Installation

Environment Configuration

Backend (backend/.env)

Locations Service (locations-service/.env)

Geolocation Service (geolocation-service/.env)

Map UI Service (map-ui/.env)

Frontend

Running the Services

API Documentation

Backend API (Port 5000)

Authentication

User Management

Locations

System

Locations Service (Port 5001)

Geolocation Service (Port 5002)

Map UI Service (Port 5174)

Database Schemas

User (backend/models/User.js)

Location (backend/models/Location.js)

FirewoodLocation (locations-service/models/FirewoodLocation.js)

Authentication

Usage

Roadmap

Contributing

License

Contact

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Backend (`backend/.env`)

Locations Service (`locations-service/.env`)

Geolocation Service (`geolocation-service/.env`)

Map UI Service (`map-ui/.env`)

User (`backend/models/User.js`)

Location (`backend/models/Location.js`)

FirewoodLocation (`locations-service/models/FirewoodLocation.js`)

Packages