User Stories for Milestone 1

README.md

@@ -1,4 +1,4 @@
-# [your app name here]
+# ConveneCrew
 
 CodePath WEB103 Final Project
 
@@ -10,11 +10,43 @@ Designed and developed by: [your names here]
 
 ### Description and Purpose
 
-[text goes here]
+**ConveneCrew** is a location-based social event discovery platform that helps people find, create, and attend events in their area. The app combines **Ticketmaster's Discovery API** for large-scale public events (concerts, sports, festivals) with **user-created local events** stored in our own database, so users see both known ticketed events and community-hosted gatherings in one place.
+
+On first sign-up, users select **interest tags** (Music, Sports, Tech, Arts, Food, etc.) during onboarding. The home dashboard uses those interests, along with the user's location and event date, to surface relevant recommendations. An interactive **Google Maps** view (2D and 3D) plots nearby events on a map, supports turn-by-turn directions, and makes it easy to explore what's happening around you without switching between multiple apps or websites.
+
+Users can create and manage their own events, join events as attendees, message organizers, and connect with others through features like **live presence** ("I'm free now") and **instant meetups**. An admin panel gives platform moderators tools to manage users, events, reports, and system settings.
+
+The purpose of ConveneCrew is to solve a common problem: **finding social events that actually match what you care about, where you are, and when you're available.**
+
+Most people today bounce between event platforms, social media, group chats, and map apps just to answer three questions:
+
+1. What's happening near me?
+2. Does it match my interests?
+3. Can I get there, and is anyone else going?
+
+ConveneCrew brings those answers into one experience by:
+
+- Aggregating event data from Ticketmaster and local user-created listings
+- Personalizing discovery through interest tags and location-based filtering
+- Visualizing events on a map so users can see proximity at a glance
+- Empowering hosts to create discoverable events without needing a large marketing budget or existing audience
+- Supporting community connection so attendees can join events, chat, and coordinate in real time
+
+Our goal is to make going out feel less like research and more like a **vibe check**, quickly seeing what fits your mood, your schedule, and your neighborhood.
 
 ### Inspiration
 
-[text goes here]
+ConveneCrew was inspired by the gap between **big ticketed events** and **everyday social gatherings**.
+
+Ticketmaster and similar platforms are great for major concerts and sports, but they don't cover the house show, pickup basketball game, open mic night, or pop-up food event happening two blocks away. At the same time, community events on Facebook, Instagram, or Discord are often hard to discover unless you already know the right group or person.
+
+We wanted to build something that feels like:
+
+- **"What's near me right now?"** powered by geolocation and Google Maps
+- **"What matches my vibe?"** powered by interest tags and personalized suggestions
+- **"I don't want to wait to make plans"** supported by live presence and instant meetup features for spontaneous connection
+
+The capstone team's shared user stories (seeing events on a map, hosting discoverable gatherings, editing event details, and finding things that match your interests) shaped the product direction. ConveneCrew is our answer: a single platform where **hosts gain visibility**, **attendees gain discovery**, and **admins keep the community safe and organized**.
 
 ## Tech Stack
 

planning/user_stories.md

@@ -10,4 +10,25 @@ Reference the Writing User Stories final project guide in the course portal for
 
 [👉🏾👉🏾👉🏾 Include at least at least 10 user stories in this format:]
 
-1. As a [user role], I want to [what], so that [why].
+### Attendee
+
+1. As an attendee, I want to see a list of social events that match my interests so that I can choose one to attend and have a good time.
+2. As an attendee, I want to see a map that shows nearby events, both known (ticketed) and unknown (community-hosted), so that I can quickly gauge what's happening around me.
+3. As a new user, I want to select interest tags during onboarding so that my recommendations are relevant from the start.
+4. As an attendee, I want my home dashboard to reflect my location and available dates so that I only see events I could realistically attend.
+5. As an attendee, I want to see a map that shows me nearby events that are known, and unknown.
+
+### Host
+
+6. As a host, I want to create an event with details like location, time, and category so that others can discover and join it.
+7. As a host, I want to edit my event's details so that attendees always have accurate, up-to-date information.
+8. As a host, I want to see who has joined my event so that I can plan for capacity and communicate with attendees.
+9. As a host, I want to be able to delete my event if plans have changed last minute or the bad weather is imminent.
+
+### Admin(possibly stretch goal)
+
+10. As an admin, I want to view basic platform stats (like total users and events) so that I can get a sense of platform activity at a glance.
+11. As an admin, I want to view and manage user accounts so that I can suspend or remove people who violate platform policies.
+12. As an admin, I want to log in through a separate admin view so that admin tools aren't mixed in with the regular user experience.
+13. As an admin, I want to search for a user by name or email so that I can find their account quickly when responding to a report.
+s