From 217c8ea67474155db926d242aa03373b65ac25a0 Mon Sep 17 00:00:00 2001 From: mcull Date: Mon, 29 Sep 2025 21:22:22 -0700 Subject: [PATCH 1/2] feat: create comprehensive Features & FAQ page --- src/app/features/page.tsx | 25 ++++++++++++ src/components/FAQ.tsx | 86 +++++++++++++++++++++++++++++++++------ src/components/Footer.tsx | 13 +----- 3 files changed, 100 insertions(+), 24 deletions(-) create mode 100644 src/app/features/page.tsx diff --git a/src/app/features/page.tsx b/src/app/features/page.tsx new file mode 100644 index 0000000..89959f7 --- /dev/null +++ b/src/app/features/page.tsx @@ -0,0 +1,25 @@ +import { Box } from '@mui/material'; + +import { FAQ } from '@/components/FAQ'; +import { FeatureShowcase } from '@/components/FeatureShowcase'; +import { brandColors } from '@/theme/brandTokens'; + +export const metadata = { + title: 'Features & FAQ | StuffLibrary', + description: + 'Learn how StuffLibrary works, why neighbors love sharing, and get answers to common questions about our community sharing platform.', +}; + +export default function FeaturesPage() { + return ( + + + + + ); +} diff --git a/src/components/FAQ.tsx b/src/components/FAQ.tsx index f5b8676..3599d8b 100644 --- a/src/components/FAQ.tsx +++ b/src/components/FAQ.tsx @@ -16,44 +16,106 @@ import { brandColors, spacing } from '@/theme/brandTokens'; const faqs = [ { - question: 'How do I know I can trust my neighbors?', + category: 'Getting Started', + question: 'How do I get started?', answer: - 'Every user goes through identity verification and builds a reputation through successful sharing. Our community guidelines and rating system help maintain trust and accountability.', + 'Simply sign up, verify your identity, and start browsing or sharing items in your neighborhood library. You can join an existing library or create a new one for your community.', }, { - question: 'What if something gets damaged or lost?', + category: 'Getting Started', + question: 'Do I need to own items to join?', answer: - 'We have clear community guidelines about item care. Most issues are resolved between neighbors, but we provide support for disputes and have optional coverage for valuable items.', + 'Not at all! You can join purely to borrow from neighbors. Sharing items is optional—some people love lending, others prefer borrowing. Both strengthen the community.', }, { - question: 'How much does it cost to use StuffLibrary?', + category: 'Getting Started', + question: 'How do I create or join a library?', answer: - 'StuffLibrary is free to use! We believe sharing should be accessible to everyone. We may introduce premium features in the future, but basic sharing will always be free.', + 'During signup, you can search for existing libraries in your area or create a new one. Libraries are typically organized by neighborhood, building, or community group.', }, { + category: 'Using the Platform', question: 'What kinds of items can I share?', answer: - 'Almost anything! Tools, outdoor equipment, kitchen appliances, books, games, and more. We prohibit items that are unsafe, illegal, or consumable for safety reasons.', + 'Almost anything! Tools, outdoor equipment, kitchen appliances, books, games, camping gear, and more. We only prohibit items that require registration or licensing (like firearms), age-restricted items, or consumables.', }, { + category: 'Using the Platform', question: 'How do I arrange pickup and return?', answer: - 'You and the item owner coordinate directly through our messaging system. Most people arrange porch pickups, but you can meet however works best for both parties.', + 'You coordinate directly with the item owner through notifications. Most people arrange porch pickups or quick doorstep handoffs, but you can meet however works best for both of you.', + }, + { + category: 'Using the Platform', + question: 'How long can I borrow something?', + answer: + 'That depends on the item and what you work out with the owner. Some items like ladders might be needed for just a day, while books could be borrowed for weeks. Communication is key!', + }, + { + category: 'Using the Platform', + question: 'Can I borrow multiple items at once?', + answer: + 'Yes! You can borrow from multiple neighbors simultaneously. Just be respectful of return times and item care—your reliability builds trust in the community.', }, { + category: 'Using the Platform', question: 'What if I need something that no one has shared yet?', answer: - "You can post a request describing what you need! Your neighbors will get notified and can offer to share if they have it. It's a great way to discover items you didn't know were available.", + 'Use the feedback button in the lower right corner to share your idea! Your neighbors will get notified, and it helps the community understand what items would be most valuable to share.', }, { - question: 'How do I get started?', + category: 'Trust & Safety', + question: 'How do I know I can trust my neighbors?', answer: - "Once we launch in your area, simply sign up, verify your identity, and start browsing or sharing items. We'll send updates as we expand to new neighborhoods.", + 'Every user verifies their identity during signup. Beyond that, trust is built through successful sharing experiences. Our community guidelines emphasize care, accountability, and neighborly respect.', }, { + category: 'Trust & Safety', + question: 'What if something gets damaged or lost?', + answer: + 'We have clear community guidelines about item care and responsibility. Most issues are resolved between neighbors through honest communication. Accidents happen—approach with understanding, and most people step up to make things right.', + }, + { + category: 'Trust & Safety', + question: "What happens if someone doesn't return my item?", + answer: + "Reach out to them first—sometimes people just forget! If that doesn't work, you can report the issue. Repeated violations affect community trust, and we take these seriously.", + }, + { + category: 'Trust & Safety', question: 'Is my personal information safe?', answer: - 'We take privacy seriously. We only share the minimum information needed for safe transactions. Your full address is never public - only general neighborhood area.', + "Yes. We only share the minimum information needed for safe transactions. Your full address is never public—only your general neighborhood. We don't sell data, show ads, or track your stuff for commercial purposes. This is a civic utility, not a business.", + }, + { + category: 'Cost & Philosophy', + question: 'How much does it cost to use StuffLibrary?', + answer: + "StuffLibrary is completely free. No ads, no affiliate links, no hidden fees. We believe sharing should be accessible to everyone, and we're committed to keeping it that way.", + }, + { + category: 'Cost & Philosophy', + question: 'Can I charge for lending my items?', + answer: + "No. StuffLibrary is designed for neighborly sharing, not rental transactions. If you're looking to rent items commercially, other platforms serve that purpose. Here, we're building community through generosity.", + }, + { + category: 'Cost & Philosophy', + question: "How do you make money if it's free?", + answer: + "We don't—not yet, anyway. StuffLibrary is a passion project focused on proving that community-driven sharing can work. We're exploring sustainable funding models that preserve our values: no ads, no data collection, no commercialization of neighborly trust.", + }, + { + category: 'Technical', + question: 'Do I need to download an app?', + answer: + 'No! StuffLibrary works in your mobile browser. Just visit stufflibrary.org from your phone, and it works like an app. You can even add it to your home screen for quick access.', + }, + { + category: 'Technical', + question: 'What are those watercolor illustrations?', + answer: + "When you add an item, AI analyzes your photo and generates a unique watercolor illustration. It's part of our library card aesthetic—nostalgic, friendly, and distinctly StuffLibrary. Plus it keeps your actual photos private.", }, ]; diff --git a/src/components/Footer.tsx b/src/components/Footer.tsx index e2daa3b..3f6765c 100644 --- a/src/components/Footer.tsx +++ b/src/components/Footer.tsx @@ -13,26 +13,15 @@ const footerSections = [ { title: 'Product', links: [ - { label: 'How It Works', href: '#' }, - { label: 'Features', href: '#' }, - { label: 'Safety', href: '#' }, - ], - }, - { - title: 'Company', - links: [ + { label: 'Features & FAQ', href: '/features' }, { label: 'About Us', href: '/about' }, - { label: 'Our Mission', href: '#' }, - { label: 'Success Stories', href: '#' }, ], }, { title: 'Support', links: [ - { label: 'Community Guidelines', href: '#' }, { label: 'Feedback', href: '/feedback' }, { label: 'Contact Us', href: 'mailto:hello@stufflibrary.org' }, - { label: 'Report Issue', href: '#' }, ], }, ]; From cb634fda2700553675f3d6f71df4aa678848635a Mon Sep 17 00:00:00 2001 From: mcull Date: Mon, 29 Sep 2025 22:47:33 -0700 Subject: [PATCH 2/2] feat: humanize About page with personal story from Marc Cull MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Complete rewrite of the About page with a conversational, personal tone: - Personal introduction from Marc Cull (CTO at FreeWorld nonprofit) - Removed academic Ostrom principles content - Added friendly, "over coffee" tone explaining the origin story - Emphasized the problem (wasteful duplication), the solution (simple sharing), and current status (Oakland soft launch) - Highlighted non-commercial values and civic utility focus - Prepared Avatar component for optional photo (currently commented out) Addresses user request to make the page more plainspoken and human, less academic. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- src/app/about/page.tsx | 464 +++++++++++++++-------------------------- 1 file changed, 166 insertions(+), 298 deletions(-) diff --git a/src/app/about/page.tsx b/src/app/about/page.tsx index 253402f..023fc34 100644 --- a/src/app/about/page.tsx +++ b/src/app/about/page.tsx @@ -20,32 +20,43 @@ export default function AboutPage() { py: { xs: spacing.sm, md: spacing.lg }, }} > - - {/* Hero Section */} + + {/* Personal Intro */} + {/* Optional: Add photo when ready */} + {/* */} - Share more, buy less. + Hi, I'm Marc. - The idea behind stuff libraries + I made this because I wanted it to exist. @@ -55,151 +66,203 @@ export default function AboutPage() { - 🏠 Too Much Stuff, Not Enough Use + We buy so much stuff we barely use. - Think about your garage or closet. How many things do you have - that you only use once in a while? Maybe it's a drill for - hanging pictures, or a fancy cake pan for birthdays, or camping - gear you use twice a year. + Think about your garage or closet. How much of it do you + actually use regularly? For me, it's maybe 20%. The rest + sits there—a drill I need twice a year, camping gear that gets + one summer trip, kitchen gadgets for special occasions. - Now think about your neighbors. They probably have the same - problem! Everyone buying the same things, using them rarely, and - running out of space to store them all. + And here's the thing: my neighbors probably have the exact + same stuff, also sitting unused. We're all storing the same + things, all paying for them, all running out of space. It just + feels wasteful. - {/* The Solution */} - + {/* The Aha */} + - 🤝 So let's make it easier to share. + What if we just... shared? - What if it were easier for us to pool our stuff among friends - and neighbors? What if it were easier to see what the folks - around us have and are willing to share? + Not in a complicated way. Just: "Hey, I have a ladder if + you need one." "Can I borrow your leaf blower this + weekend?" That's it. - When communities work together to use things more wisely, - everyone wins. Instead of everyone owning everything, we share - what we have. + The awkwardness is what stops us. You don't want to impose. + You don't know who has what. You feel weird asking to + borrow from someone you barely know. So we all just buy more + stuff instead. - {/* The Research */} - + {/* The Solution */} + - 🏛️ But does sharing actually work? + So I built StuffLibrary. - A lot of people are skeptical about sharing in practice. - Won't things get broken, or unfairly used if there's - no central authority to supervise? + It's pretty simple: you can see what your neighbors have + and are willing to share. They can see what you have. When you + need something, you check the library first. No awkward knocking + on doors, no guessing who might have a power drill. - Nobel Prize-winning economist Elinor Ostrom discovered that - communities all over the world are great at sharing common - resources. When it works well, it's because these - principles are in place: clear boundaries, collective choice, - monitoring, graduated sanctions, conflict resolution, - recognition of rights, nested enterprises, and accountable - governance. + I wanted to make something useful and kind of beautiful, without + it having to be commercial. No ads, no data mining, no + "growth hacking." Just neighbors helping neighbors, + with nice design that doesn't feel like a corporate + product. + + + + {/* Why It Matters */} + + - Inspired by her research, we've designed this app to help - communities of friends and neighbors share well and buy less - stuff. + Why this matters + + + + Save money. Borrow instead of buying things + you'll use once or twice. + + + + + Less waste. The stuff we already own gets + used more. We buy less new stuff. + + + + + Actual community. You get to know your + neighbors. Not in a forced way—just through the normal act + of helping each other out. + + + {/* How It Works */} - + - ✨ How Stuff Libraries Work + How it works @@ -235,7 +297,7 @@ export default function AboutPage() { mb: 1, }} > - Share Your Stuff + Add your stuff - Take pictures of things you don't use often and share - them with neighbors + Snap a photo of things you don't use often @@ -266,7 +327,7 @@ export default function AboutPage() { mb: 1, }} > - Find What You Need + Browse what's available - Look for things you need instead of buying them new + See what your neighbors are sharing @@ -296,7 +357,7 @@ export default function AboutPage() { mb: 1, }} > - Make Friends + Coordinate & borrow - Get to know your neighbors while helping each other out + Work out pickup/return that works for both of you - {/* Platform Features Mapped to Ostrom's Principles */} - - - - 🔧 How the platform supports good sharing - - - - - - - 🏠 Clear Boundaries - - - Library membership defines who can participate and - access shared items. - - - - - 🗳️ Collective Choice - - - [Placeholder for community governance features] - - - - - 👀 Monitoring - - - Borrow/return tracking and item condition reporting - provide transparency. - - - - - ⚖️ Graduated Sanctions - - - [Placeholder for community moderation system] - - - - - - - - - 🤝 Conflict Resolution - - - Direct messaging and community guidelines help resolve - issues. - - - - - 🏅 Recognition of Rights - - - Clear ownership records and borrower/lender protections - respect everyone's rights. - - - - - 🌐 Nested Enterprises - - - Multiple libraries can connect and coordinate at - different scales. - - - - - 📋 Accountable Governance - - - [Placeholder for community leadership and accountability - features] - - - - - - - - - {/* Call to Action */} + {/* Where We Are */} - ✨ Share more, buy less, see how it goes! + We're just getting started. - Communities are pretty good at sharing when they have the right - tools and structure. We're building those tools. + I soft-launched this in Oakland with friends and family. We + 're learning what works, what doesn't, and what people + actually need. + This is a side project, not a startup. I'm the CTO at a + nonprofit called FreeWorld, and I built StuffLibrary because I + wanted to make something useful that doesn't have to be a + business. + + - Want to try it out with your friends and neighbors? + If you're in the Bay Area and want to start a library in + your neighborhood, give it a try. If you have feedback, I + 'd love to hear it. Let's see if we can make sharing + less awkward and more normal.