dev2main

.env.example

@@ -0,0 +1,32 @@
+# ---------- SUPABASE ----------
+VITE_SUPABASE_URL=https://your-project.supabase.co
+VITE_SUPABASE_ANON_KEY=your-anon-key-here
+SUPABASE_SERVICE_ROLE_KEY=your-service-role-key-here
+
+# ---------- EMAIL SERVICE ----------
+RESEND_API_KEY=your-resend-api-key-here
+
+# ---------- CAPTCHA ----------
+VITE_HCAPTCHA_SITE_KEY=458ab136-5512-4228-8256-9a0ee862c176
+HCAPTCHA_SECRET_KEY=ES_36462d6276ff498995c31791e6c8acc2
+
+# ---------- EMAIL SERVICE ----------
+RESEND_API_KEY=your-resend-api-key-here
+
+# ---------- STORAGE BUCKETS ----------
+VITE_STORAGE_BUCKET_ATTACHMENTS=comment-attachments
+VITE_STORAGE_BUCKET_EXPORTS=agency-exports
+VITE_STORAGE_BUCKET_AGENCY_ASSETS=agency-assets
+
+# ---------- APPLICATION ----------
+VITE_SITE_URL=http://localhost:5173
+VITE_EMAIL_FROM=notifications@opencomments.us
+VITE_SUPPORT_EMAIL=support@opencomments.us
+
+# ---------- DEVELOPMENT ----------
+NODE_ENV=development
+VITE_DEBUG_MODE=false
+
+# ---------- OPTIONAL FEATURES ----------
+VITE_ENABLE_ANALYTICS=false
+VITE_MAX_FILE_SIZE_MB=10

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/custom.md

@@ -0,0 +1,10 @@
+---
+name: Custom issue template
+about: Describe this issue template's purpose here.
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

README.md

@@ -1 +1,141 @@
-opencomments
+# OpenComments
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Open Source](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://opensource.org/)
+[![Built by MetaPhase](https://img.shields.io/badge/Built%20by-MetaPhase-blue)](https://metaphase.tech)
+[![Status](https://img.shields.io/badge/Status-Active-brightgreen)](https://status.opencomments.us)
+[![Deploy Status](https://api.netlify.com/api/v1/badges/your-site-id/deploy-status)](https://app.netlify.com/sites/your-site-name/deploys)
+[![CI/CD](https://github.com/MetaPhase-Consulting/opencomments/workflows/CI%2FCD%20Pipeline/badge.svg)](https://github.com/MetaPhase-Consulting/opencomments/actions)
+[![Accessibility](https://img.shields.io/badge/Accessibility-WCAG%202.1%20AA-green)](https://www.w3.org/WAI/WCAG21/quickref/)
+[![Security](https://img.shields.io/badge/Security-SOC%202-blue)](https://supabase.com/security)
+[![Uptime](https://img.shields.io/badge/Uptime-99.9%25-brightgreen)](https://status.opencomments.us)
+[![Version](https://img.shields.io/github/package-json/v/MetaPhase-Consulting/opencomments)](https://github.com/MetaPhase-Consulting/opencomments/releases)
+
+# OpenComments
+
+OpenComments is a modern, accessible public commenting platform that enables transparent government by making it easy for agencies to collect, moderate, and publish public feedback on policies and proposals.
+
+## 🏛️ Project Purpose
+
+OpenComments bridges the gap between government agencies and citizens by providing a secure, user-friendly platform for public comment periods. Built with modern web technologies and designed for accessibility, it ensures every voice can be heard in the democratic process.
+
+## 🛠️ Tech Stack
+
+- **Frontend**: React 18 + TypeScript + Tailwind CSS
+- **Backend**: Supabase (PostgreSQL + Auth + Storage + Edge Functions)
+- **Testing**: Vitest + Cypress + Playwright
+- **Deployment**: Netlify (Frontend) + Supabase (Backend)
+- **CI/CD**: GitHub Actions
+
+## 🚀 Quick Start
+
+### Prerequisites
+- Node.js 18+
+- npm or yarn
+- Supabase account
+
+### Setup
+```bash
+# Clone repository
+git clone https://github.com/your-org/opencomments.git
+cd opencomments
+
+# Install dependencies
+npm install
+
+# Copy environment template
+cp .env.example .env
+
+# Configure your Supabase credentials in .env
+# VITE_SUPABASE_URL=https://your-project.supabase.co
+# VITE_SUPABASE_ANON_KEY=your-anon-key
+
+# Apply database migrations
+npm run db:migrate
+
+# Start development server
+npm run dev
+```
+
+Visit `http://localhost:5173` to see the application.
+
+## 📁 Folder Structure
+
+```
+opencomments/
+├── src/
+│   ├── components/          # Reusable UI components
+│   ├── pages/              # Route components
+│   │   ├── agency/         # Agency admin portal
+│   │   └── public/         # Public-facing pages
+│   ├── hooks/              # Custom React hooks
+│   ├── contexts/           # React context providers
+│   ├── lib/                # Utilities and configurations
+│   └── types/              # TypeScript type definitions
+├── supabase/
+│   ├── migrations/         # Database schema changes
+│   └── functions/          # Edge functions
+├── tests/                  # Test files
+├── docs/                   # Documentation
+└── public/                 # Static assets
+```
+
+## 🧪 Development
+
+### Testing
+```bash
+# Run unit tests
+npm run test
+
+# Run E2E tests
+npm run cypress:run
+
+# Run accessibility tests
+npm run test:a11y
+```
+
+### Database
+```bash
+# Apply migrations
+npm run db:migrate
+
+# Reset database (development only)
+supabase db reset
+```
+
+### Quality Assurance
+Before deploying, ensure all tests pass:
+1. Unit tests: `npm run test`
+2. E2E tests: `npm run cypress:run`
+3. Accessibility: `npm run test:a11y`
+4. Manual QA: Follow `QA_CHECKLIST.md`
+
+## 📚 Documentation
+
+- **[DEVELOPER.md](docs/DEVELOPER.md)** - Development setup and workflows
+- **[ARCHITECTURE.md](docs/ARCHITECTURE.md)** - System design and technical overview
+- **[DATAMODEL.md](docs/DATAMODEL.md)** - Database schema and relationships
+- **[AGENCY_ADMIN_GUIDE.md](docs/AGENCY_ADMIN_GUIDE.md)** - Guide for government staff
+- **[PUBLIC_USER_GUIDE.md](docs/PUBLIC_USER_GUIDE.md)** - Guide for citizens
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🆘 Support
+
+- **Documentation**: Check the `docs/` folder for detailed guides
+- **Issues**: Report bugs via GitHub Issues
+- **Email**: [support@opencomments.us](mailto:support@opencomments.us)
+
+---
+
+**Built with ❤️ for transparent government**

SECURITY.md

@@ -0,0 +1,21 @@
+# Security Policy
+
+## Supported Versions
+
+Use this section to tell people about which versions of your project are
+currently being supported with security updates.
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 5.1.x   | :white_check_mark: |
+| 5.0.x   | :x:                |
+| 4.0.x   | :white_check_mark: |
+| < 4.0   | :x:                |
+
+## Reporting a Vulnerability
+
+Use this section to tell people how to report a vulnerability.
+
+Tell them where to go, how often they can expect to get an update on a
+reported vulnerability, what to expect if the vulnerability is accepted or
+declined, etc.