Open-source blog platform designed for agricultural technology enthusiasts, IoT engineers, and smart farming innovators
A modern, SEO-optimized blog platform specifically crafted for the agricultural technology community. Born from real-world IoT engineering experience and designed to help others share their AgriTech journey.
This platform was created to solve a real problem: there's a lack of accessible, personal perspectives on AgriTech and IoT engineering. Most agricultural technology content is either too academic or too commercial. This blog platform provides a space for:
- 🔧 Real IoT engineering experiences (RS485, Modbus, embedded systems)
- 🌱 Smart farming insights from practitioners
- 📚 Beginner-friendly technical explanations
- 🤝 Community knowledge sharing
- Rich Markdown Editor with live preview and auto-save
- AI-Powered Tagging for content organization
- Bulk Operations for efficient content management
- Draft System with seamless publishing workflow
- AI Chatbot Optimized (ChatGPT, Claude, Perplexity discovery)
- Dynamic XML Sitemaps with real-time updates
- Open Graph Images for social sharing
- Structured Data (JSON-LD) for rich snippets
- Mobile-First Design for optimal indexing
- TypeScript throughout for type safety
- Modern React with hooks and suspense
- Vercel Serverless functions for scalability
- MongoDB for flexible data storage
- Hot Reload development environment
npm run devThen open: http://localhost:5173
That's it! 🎉
- ✅ Frontend + Backend running
- ✅ Hot reload enabled
- ✅ API proxy configured
- ✅ Admin panel at
/admin - ✅ Debug tools included
- Node.js 18+
- MongoDB Atlas account (free tier works)
- Git
git clone https://github.com/asamountain/AgriTechBlog.git
cd AgriTechBlog
npm installcp env.example .envEdit .env with your MongoDB connection:
MONGODB_URI=mongodb+srv://your-connection-string
SESSION_SECRET=your-random-secret-keynpm run devVisit http://localhost:5173 and start creating! 🚀
Explore the live platform to see:
- Real AgriTech blog posts about RS485, Modbus, IoT engineering
- Admin dashboard for content management
- SEO optimization in action
- Mobile-responsive design
AgriTechBlog/
├── 📱 client/src/ # React frontend
│ ├── components/ # Reusable UI components
│ ├── pages/ # Application routes
│ ├── hooks/ # Custom React hooks
│ └── lib/ # Utilities
├── 🚀 api/ # Vercel serverless functions
├── 🔧 server/ # Development server
├── 📊 shared/ # TypeScript types
└── 📚 docs/ # Documentation
- Frontend: React 18 + TypeScript + Vite + Tailwind CSS
- Backend: Node.js + MongoDB + Vercel Serverless
- UI Components: Radix UI + Custom AgriTech theme
- Development: Hot reload + TypeScript strict mode
- 🌲 Forest Green Primary (#2D5016) - Representing nature and growth
- 📐 Golden Ratio Proportions (1:1.618) - Mathematical harmony
- 📱 Mobile-First - Accessible anywhere, anytime
- ⚡ Performance-Optimized - Fast loading for better UX
- Clean typography for technical content
- Code-friendly markdown support
- Image optimization for agricultural photos
- SEO-optimized for discoverability
We welcome contributors of all levels! Whether you're:
- 🌱 New to coding - Great first-time contributor opportunities
- 🔧 IoT/AgriTech expert - Share your domain knowledge
- 💻 Experienced developer - Help with architecture and optimization
- 📝 Content creator - Improve documentation and guides
- 🍴 Fork the repository
- 🌿 Create your feature branch
git checkout -b feature/amazing-feature
- 💻 Make your changes
- Follow our coding standards
- Add tests for new features
- Update documentation as needed
- ✅ Test your changes
npm run build # Ensure it builds npm run dev # Test locally
- 📝 Commit with clear message
git commit -m "✨ Add amazing feature for AgriTech users" - 🚀 Push and create PR
git push origin feature/amazing-feature
Look for issues labeled good-first-issue:
- 📝 Documentation improvements
- 🎨 UI/UX enhancements
- 🐛 Bug fixes
- 🌐 Accessibility improvements
- 🔍 Advanced search functionality
- 🌍 Multi-language support
- 📊 Analytics dashboard
- 🔔 Email newsletter system
- 🎥 Video content support
- 📱 Progressive Web App features
# Build the project
npm run build
# Deploy to Vercel
npx vercel --prod
# Environment variables needed:
# - MONGODB_URI
# - SESSION_SECRET| Variable | Description | Required |
|---|---|---|
MONGODB_URI |
MongoDB connection string | ✅ Yes |
SESSION_SECRET |
Session encryption key | ✅ Yes |
NODE_ENV |
Environment (development/production) | ❌ No |
This platform is optimized for maximum discoverability:
- ✅ Dynamic XML sitemaps
- ✅ Robots.txt optimization
- ✅ Meta tags and Open Graph
- ✅ Structured data (JSON-LD)
- ✅ Mobile-first indexing
- ✅ Optimized for ChatGPT, Claude, Perplexity
- ✅ Clear content structure
- ✅ Technical depth with context
- ✅ Personal insights and experiences
See our SEO Guide for detailed optimization strategies.
# Development
npm run dev # Start dev server
npm run build # Build for production
# Database
npm run db:test # Test MongoDB connection
# Code Quality
npm run lint # Check code style
npm run type-check # TypeScript validation
# Deployment
npm run deploy # Deploy to Vercel❌ Database connection error
# Check your MongoDB URI
echo $MONGODB_URI❌ Build fails
# Check TypeScript errors
npm run type-check❌ Admin panel not working
# Visit /admin after starting dev server
npm run dev- 📖 Check our documentation
- 🐛 Create an issue
- 💬 Join discussions
- 📧 Email: [your-email@example.com]
- 📊 Advanced analytics dashboard
- 🔍 Full-text search functionality
- 🌍 Multi-language support
- 📱 Progressive Web App features
- 🎥 Video content support
- 🤖 AI-powered content suggestions
- 🔔 Real-time notifications
- 👥 User comments and community features
- 📈 SEO performance tracking
- 🎨 Theme customization
Vote on features or suggest new ones in our discussions!
This project is licensed under the MIT License - see the LICENSE file for details.
- ✅ Free to use for personal and commercial projects
- ✅ Modify and distribute as you like
- ✅ No attribution required (but appreciated!)
- ✅ Open source forever
- 🌱 Inspiration: The AgriTech and IoT engineering community
- 🛠️ Technology: Built with amazing open-source tools
- 🤝 Contributors: Everyone who helps make this better
- 📚 Content: Real-world IoT and smart farming experiences
- 🌐 Live Demo: tech-san.vercel.app
- 📖 Documentation: docs/
- 🐛 Issues: GitHub Issues
- 💬 Discussions: GitHub Discussions
- 📧 Contact: Create an issue or discussion
If this project helps you or your organization, consider:
- ⭐ Star this repository to help others discover it
- 🐛 Report bugs and suggest improvements
- 🤝 Contribute code or documentation
- 📢 Share with others in the AgriTech community
- 💬 Join discussions and help other users
Built with ❤️ for the agricultural technology community
Started as a personal blog, growing into a platform for the entire AgriTech community to share knowledge and experiences.