Week 3: Your Gateway to 90,000+ Jurisdictions Just Got Easier - New Homepage Launch
This week we tackled critical UX issues affecting the documentation site - fixing routing conflicts, restoring the homepage with logo, and updating all navigation links to work correctly.
π§ What We Fixedβ
1. Homepage "Page Not Found" Errorβ
Problem:
http://localhost:3000/showed "page not found"- Custom homepage at
src/pages/index.tsxcouldn't render - CommunityOne logo missing
- Routing conflict with Docusaurus configuration
Solution:
- Changed
routeBasePathfrom/to/docs/ - Docs now served at
/docs/path - Custom homepage renders at root
/ - Logo displays correctly
2. Updated All Navigation Linksβ
Fixed 7 files with 155 insertions:
Configuration Updates:
docusaurus.config.ts- Navbar, footer, logo linkssrc/pages/index.tsx- Homepage pathway cards, CTA buttons
Documentation Updates:
intro.md- Updated all internal links to/docs/prefixfor-advocates.md- Fixed policy maker navigationfor-developers.md- Corrected developer guide linksdashboard.md- Updated dashboard referencescitations.md- Added Open Data Impact section
3. New URL Structureβ
With routeBasePath: '/docs/':
| What You Want | Correct URL |
|---|---|
| Homepage | http://localhost:3000/ |
| Introduction | http://localhost:3000/docs/intro |
| Citations | http://localhost:3000/docs/data-sources/citations |
| Policy Makers Guide | http://localhost:3000/docs/for-advocates |
| Developer Guide | http://localhost:3000/docs/for-developers |
| Dashboard | http://localhost:3000/docs/dashboard |
β¨ Homepage Featuresβ
The new custom homepage includes:
Header:
- CommunityOne logo (SVG)
- "Open Navigator" branding
- Tagline: "Find opportunities in local meetings and budgets"
Audience Pathways: Two cards guiding users based on role:
- π Policy Makers & Advocates β
/docs/for-advocates - π οΈ Developers & Technical Users β
/docs/for-developers
Feature Highlights:
- π Meeting Minutes & Financial Documents (90,000+ jurisdictions)
- π€ Automated Analysis (AI-powered document processing)
- π° Words vs Money (Budget vs meeting minute correlation)
- π Free Public Data (Census, school district, nonprofit data)
- πΊοΈ Visual Map (Geographic opportunity discovery)
- π§ Draft Materials (Automated email and campaign content)
Call-to-Action:
- Launch main application (React app on port 5173)
- Access documentation sections
- Explore data sources
π Build Statusβ
Documentation now builds successfully:
- β All routes working
- β No TypeScript errors
- β Logo displays correctly
- β Navigation links functional
- β Warnings for broken links identified (to be fixed next week)
π What's Nextβ
Week of April 27:
- Add civic tech section to homepage
- Fix broken anchor links
- Update legacy markdown references
- Test deployment to HuggingFace Spaces
Week of May 4:
- Launch production deployment
- Set up custom domain (www.communityone.com)
- Configure OAuth providers
- Enable user authentication
Week of May 11:
- Start data extraction pipelines
- Ingest first batch of civic tech projects from GitHub
- Test hackathon event calendar
- Deploy brigade chapter directory
π― Roadmap: Weekly Blog Posts for 2026β
Here's what to expect in upcoming weekly updates:
May 2026: Production Deployment
- Week 1: HuggingFace Spaces deployment
- Week 2: Custom domain & SSL setup
- Week 3: OAuth integration (GitHub, Google)
- Week 4: First production users
June 2026: Data Extraction
- Week 1: GitHub API integration for civic tech projects
- Week 2: Hackathon event calendar (National Day of Civic Hacking)
- Week 3: Brigade chapter directory (Code for America)
- Week 4: First 1,000 civic tech projects indexed
July 2026: Analytics & Dashboards
- Week 1: Community solution templates
- Week 2: Metric views for common use cases
- Week 3: Budget-to-minutes correlation analysis
- Week 4: First real-world case study
August 2026: Community Engagement
- Week 1: Partner with first local brigade
- Week 2: Data Academy pilot program (Brookings model)
- Week 3: Hackathon participation (CodeAcross prep)
- Week 4: User feedback and iteration
September-December 2026: Scale & Impact
- Monthly: New jurisdiction data (target: 100K+ cities/counties)
- Monthly: Nonprofit data expansion (target: 5M+ organizations)
- Monthly: Meeting minute ingestion (target: 1M+ documents)
- Quarterly: Major feature releases
2027 Goals:
- Full coverage of U.S. jurisdictions
- International expansion (Canada, UK)
- Real-time meeting monitoring
- AI-powered policy impact predictions
π Try It Outβ
Visit the new homepage at http://localhost:3000/ to see the redesigned landing page with pathway cards, feature highlights, and clear calls-to-action.
All documentation is now accessible with the /docs/ prefix - no more "page not found" errors!
Next Post: Production Deployment & HuggingFace Spaces Setup (Week of April 27)
