Learn the wild plants growing around you.
Urban Forager is an educational, offline-friendly foraging app designed to help people learn about the edible, medicinal, and nutritional uses of common wild plants — especially the “weeds” most people overlook.
Built entirely with kodeWeave, the app features:
- A full plant library with multiple verified images per plant
- Detailed edibility, medicinal, and safety information
- Clear identification features & warning notes for toxic lookalikes
- A quiz mode to help users learn through play
- Runs 100% client-side — no server required
The goal: free survival knowledge for everyone.
✅ Full Plant Library – Explore detailed profiles of wild edible & medicinal plants
✅ High-Quality Plant Images – Multiple verified photos per plant
✅ Identification Guidance – Leaf shapes, flowers, stems, growth patterns & more
✅ Look-Alike Warnings – Toxic vs edible distinctions made clear
✅ Edible Parts & Uses – Culinary, nutritional, and historical medicinal info
✅ Safety First – Strong caution notes where risk exists
✅ Interactive Quiz Mode – Learn through fun questions
✅ Offline-Friendly – Works in your browser, no internet required
✅ Lightweight & Fast – No bloat, no tracking, no nonsense
Urban Forager includes a built-in quiz system to help users actually learn, not just read.
Quiz categories include:
- 🕵️ Identification
- 🥗 Edible Uses
- 🌿 Medicinal Uses
- ☠️ Toxic Plants
- 👯 Look-Alikes
- 🌍 Habitat
- 🍳 Preparation & Processing
Each question includes:
- Multiple-choice answers
- A correct answer
- A short explanation that actually teaches something
Plant data lives in the weeds array.
Each plant is stored as an object like this:
{
id: 37,
commonName: "Queen Anne's Lace (Wild Carrot)",
emoji: "🤍",
images: [...],
scientificName: "Daucus carota",
family: "Apiaceae",
description: "A wild ancestor of cultivated carrot...",
season: "Summer",
habitat: "Fields, roadsides, disturbed ground",
difficulty: "Advanced",
tags: ["Edible (Caution)", "Medicinal", "Carrot Family"],
identifyingFeatures: [...],
lookAlikes: "...",
edibleParts: [...],
harvestingNotes: "...",
culinaryUses: [...],
recipes: [...],
medicinalUses: [...],
preparationMethods: [...],
safetyNotes: "...",
nutritionalSummary: "",
nutrients: [...],
healthBenefits: [...]
}Quiz questions are stored in categorized arrays:
questions: {
identification: [
{
text: "Which weed has yellow flowers that become white puffballs?",
options: ["Plantain", "Dandelion", "Chickweed", "Curly Dock"],
correctAnswer: "Dandelion",
explanation: "Dandelion forms iconic white puffball seed heads.",
}
],
edible: [...],
medicinal: [...],
toxic: [...],
lookalikes: [...],
habitat: [...],
preparation: [...]
}Urban Forager is fully web-based.
No installation. No server. Just open and use.
Link coming soon once published 🙂
Clone the repo:
git clone https://github.com/michaelsboost/UrbanForager.git
cd UrbanForager
Run a simple local server (example using Python):
python3 -m http.server 8000
Then open:
http://localhost:8000
That’s it.
Contributions are welcome and appreciated ❤️
You can help by:
- 📸 Adding accurate plant images
- 🌿 Submitting new plant data
- 🧠 Writing quiz questions
- 🐞 Fixing mistakes or improving accuracy
This app is for educational purposes only.
- Never consume a plant unless you are 100% certain of identification
- Many plants have dangerous or deadly look-alikes
- Some plants are only edible in certain seasons or stages
- People may experience allergic reactions
- Always verify using multiple trusted sources
You are responsible for your own safety.
Urban Forager is built to be lightweight, fast, and easy to contribute to:
- ⚡ AlpineJS – simple reactive UI without large frameworks
- 🎨 Tailwind CSS – clean styling with utility classes
- ⭐ Font Awesome – icons used throughout the interface
- 🌐 100% Client-Side
- 📦 No build tools, no backend, no dependencies
Runs anywhere a browser runs.
Urban Forager is open-source under the MIT License.
See the full license: LICENSE
Awesome! Urban Forager is free and open-source, and contributions are always welcome.
🔹 Submit a Pull Request – Found a bug? Have a feature idea? Let's build together!
🔹 Spread the Word – Share Urban Forager with fellow developers, creators and nature lovers.
🔹 Fork & Experiment – Urban Forager is yours to play with—have fun with it!
If Urban Forager has been helpful to you, here are some ways you can show support:
☕ Buy me a coffee: ko-fi.com/michaelsboost
🎨 Grab some of my art prints: DeviantArt Store
👕 Get a kodeWeave T-shirt or gear: Merch Store
📚 Check out my Graphic Design Course: Learn Design
🛒 Register as a customer on my store: Visit Store
💙 Donate via PayPal: Support via PayPal
💸 Donate via Cash App: Support via SquareCash
Your support helps keep Urban Forager free, open-source, and constantly improving. 🚀
Created by: Michael Schwartz - https://michaelsboost.com Maintained by: The Open Source Community