A community engagement platform powered by Next.js and GROQ AI that fosters meaningful connections and conversations.
- How might we create more meaningful connections in online communities?
- How might we leverage AI to facilitate better community engagement?
- How might we ensure safe and authentic online interactions?
CommUnity is an innovative platform that revolutionizes online community engagement by combining the power of Next.js with GROQ AI technology. The platform provides real-time interaction capabilities, secure authentication, and AI-powered conversation moderation to create safe and meaningful online spaces. Users can engage in discussions, share resources, and build connections while the AI ensures content quality and maintains community guidelines.
Our target customers are community managers, online group administrators, and organizations looking to build engaged digital communities. CommUnity provides tangible benefits through reduced moderation overhead, increased user engagement metrics, and improved community safety. The AI-powered features help identify and promote quality conversations while automatically filtering inappropriate content, resulting in significant time and resource savings for community managers.
- Next.js (Frontend & Backend)
- MongoDB Atlas (Database)
- GROQ AI (Language Model)
- NextAuth.js (Authentication)
- TailwindCSS (Styling)
- Team photo
- Team Slack channel
- Communication established with mentor
- Repo creation from template
- Hangar registration
- Presentation complete and linked
- Video pitch recorded and linked
- Code merged to main branch
Fisk University
Fisk G13
- Awantika Bastola - Product Developer @reyyy81
- Dinesh Pandey - Full Stack Developer @dineshpandeyy
- Emmanuel Adeyemi - UX Designer @AdeyemiEmmanuel
- Folusho Adeyemi - Project Manager @folusho-adeyemi
- Pratush Khanal - Frontend Developer @Khanalpratyush
CommUnity is a modern web application built to foster community engagement and connection. Powered by Next.js and MongoDB, it provides a robust platform for community interaction with secure authentication and intelligent conversation capabilities through GROQ API integration.
- 🔐 Secure Authentication - User authentication powered by NextAuth.js
- 💾 MongoDB Integration - Reliable data persistence with MongoDB Atlas
- 🤖 AI Integration - Smart conversations powered by GROQ API
- 🎨 Modern UI - Responsive and intuitive user interface
- ⚡ Real-time Updates - Instant interaction and updates
- 📱 Mobile Responsive - Seamless experience across all devices
- Node.js (v14 or higher)
- npm or yarn
- MongoDB Atlas account
- GROQ API account
-
Clone the repository
git clone https://github.com/yourusername/commUnity.git cd commUnity -
Install dependencies
npm install # or yarn install -
Environment Setup
- Copy
.env.exampleto.env
cp .env.example .env
- Update the
.envfile with your credentials:DATABASE_URL: MongoDB connection stringNEXTAUTH_SECRET: Generate a secure random stringNEXTAUTH_URL: Your application URLGROQ_API_KEY: Your GROQ API key
- Copy
-
Start the development server
npm run dev # or yarn dev -
Open your browser Navigate to
http://localhost:3000
commUnity/
├── app/ # Next.js app directory
│ ├── api/ # API routes
│ ├── components/ # Reusable components
│ └── pages/ # Application pages
├── public/ # Static assets
├── styles/ # Global styles
├── lib/ # Utility functions
├── .env.example # Environment variables example
└── package.json # Project dependencies
- Frontend: Next.js, React, TailwindCSS
- Backend: Next.js API Routes
- Database: MongoDB Atlas
- Authentication: NextAuth.js
- AI Integration: GROQ API
- Deployment: Vercel
DATABASE_URL= # MongoDB connection string
NEXTAUTH_SECRET= # NextAuth secret key
NEXTAUTH_URL= # Application URL
GROQ_API_KEY= # GROQ API key
We welcome contributions! Please follow these steps:
- Fork the repository
- Create a new branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License
MIT License
Copyright (c) 2024 CommUnity
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
If you found this project helpful, please give it a ⭐️!
For any inquiries or support:
- Email: support@community.com
- Twitter: @CommUnityApp
- Discord: Join our community
- Next.js - The React Framework for Production
- MongoDB - Database Solution
- GROQ - AI Language Model Provider
- NextAuth.js - Authentication Solution
- TailwindCSS - Styling Framework
- Vercel - Deployment Platform
- Initial release
- Basic authentication functionality
- GROQ API integration
- Community features implementation
Common issues and their solutions:
-
Database Connection Issues
- Ensure your MongoDB connection string is correct
- Check if your IP is whitelisted in MongoDB Atlas
-
Authentication Problems
- Verify NEXTAUTH_URL matches your deployment URL
- Ensure NEXTAUTH_SECRET is properly set
-
GROQ API Issues
- Confirm your API key is valid
- Check your rate limits and usage
For more detailed troubleshooting, please check our Wiki or open an issue.
This is a Next.js project bootstrapped with create-next-app.
First, run the development server:
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun devOpen http://localhost:3000 with your browser to see the result.
You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.
This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.
To learn more about Next.js, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
You can check out the Next.js GitHub repository - your feedback and contributions are welcome!
The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.
Check out our Next.js deployment documentation for more details.