# DFW Pulse

> DFW Pulse is a community event discovery platform for the Dallas-Fort Worth metroplex, aggregating local events across 30+ cities and neighborhoods into a single, filterable feed. The platform serves residents, visitors, and local organizations seeking free and paid activities in North Texas, with emphasis on free and family-friendly events.

## Elevator Pitch

DFW Pulse is the definitive event calendar for the Dallas-Fort Worth metroplex, covering 30+ cities from Allen to Southlake with thousands of community-submitted and aggregated events spanning music, food, arts, sports, and family activities. It provides a unified discovery experience with city-based browsing, category filtering, a community blog, and a public JSON API for mobile consumption.

## Key Entities

- **DFW Events**: Community, civic, cultural, and entertainment events across the Dallas-Fort Worth metroplex
- **Cities**: Allen, Arlington, Bedford, Benbrook, Burleson, Carrollton, Colleyville, Crowley, Dallas, Denton, DeSoto, Euless, Fort Worth, Frisco, Garland, Grand Prairie, Grapevine, Haltom City, Hurst, Irving, Keller, Lewisville, Mansfield, McKinney, Mesquite, North Richland Hills, Plano, Richardson, Rockwall, Rowlett, Saginaw, Southlake
- **Event Categories**: Music & Concerts, Food & Drink, Arts & Culture, Sports & Fitness, Family & Kids, Community & Civic, Markets & Shopping, Nightlife, Comedy, Fundraisers & Charity
- **Blog / Community Guides**: Editorial posts covering free events, seasonal roundups, city-specific guides, and activity listicles for the DFW area
- **Users**: Residents and organizations who submit and manage events; admin staff who moderate submissions

## Primary URLs

### Public Pages

- [Main event feed](https://dfwpulse.com/) — filterable by city, category, tag, and date
- [City-scoped event feed](https://dfwpulse.com/dallas) — example: `/dallas`, `/fort-worth`, `/plano`
- [Blog index](https://dfwpulse.com/blog) — community editorial guides and roundups
- [About DFW Pulse](https://dfwpulse.com/pages/about)
- [Privacy Policy](https://dfwpulse.com/pages/privacy-policy)
- [HTML sitemap](https://dfwpulse.com/sitemap)
- [XML sitemap index](https://dfwpulse.com/sitemap.xml)
- [Events XML sitemap](https://dfwpulse.com/sitemap-events.xml)
- [Blog XML sitemap](https://dfwpulse.com/sitemap-blog.xml)
- [Pages XML sitemap](https://dfwpulse.com/sitemap-pages.xml)

### JSON API (public, rate-limited to 120 req/min)

- [Paginated event feed](https://dfwpulse.com/api/events/feed) — supports filtering by city, category, tags, date, free
- [Single event detail](https://dfwpulse.com/api/events/music/example-event-slug) — pattern: `/api/events/{categorySlug}/{eventSlug}`
- [All event categories](https://dfwpulse.com/api/categories) — list with slugs and icons
- [All supported cities](https://dfwpulse.com/api/cities) — list with slugs

## Content Notes

- Events span free community gatherings, ticketed concerts, farmers markets, festivals, sports, fitness classes, arts events, car shows, fundraisers, and more
- Blog posts are long-form guides targeting free and budget-friendly activities, organized by season, city, or theme
- City slugs use lowercase hyphenated names (e.g., `fort-worth`, `north-richland-hills`, `grand-prairie`)
- Event slugs include a short hex identifier suffix for uniqueness (e.g., `/dallas/toadies-ac5fce`)
- All content is scoped to the DFW metroplex in North Texas, USA