Learn the wild plants growing around you.

Urban Forager Screenshot

License Stars Issues

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:

ko-fi

☕ 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