Skip to content

ThePhoenix08/open-graph-visualizer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open Graph Visualizer

A powerful tool to preview how your website's link previews will appear across different social media platforms. Perfect for optimizing your website's Open Graph metadata and improving SEO performance.

🚀 Features

  • Real-time Preview: See how your links will look on Facebook, Twitter, LinkedIn, and other platforms
  • Metadata Analysis: Comprehensive analysis of Open Graph tags, Twitter Cards, and other meta tags
  • SEO Insights: Get recommendations to improve your social media presence
  • Responsive Design: Works seamlessly across all devices
  • Fast Performance: Built with modern technologies for optimal speed

🛠️ Tech Stack

  • Frontend: React 18, TypeScript, Tailwind CSS, shadcn/ui
  • Backend: Express.js, Node.js, TypeScript
  • Development: ESLint, Prettier, Concurrently

📋 Prerequisites

Before you begin, ensure you have the following installed:

🚀 Quick Start

  1. Clone the repository

    git clone https://github.com/ThePhoenix08/open-graph-visualizer.git
    cd open-graph-visualizer
  2. Install dependencies of root, frontend, backend

    npm install
  3. Set up environment variables for backend

    cd ./backend
    cp .env.example .env
    # Edit .env with your configuration
  4. Start the development server for both frontend and backend

    cd ..
    npm run dev
  5. Open your browser Navigate to http://localhost:5173 to see the application frontend running. Application backend should be accessible at http://localhost:5000

📁 Project Structure

open-graph-visualizer/
├── frontend/              # React frontend application
│   ├── src/
│   ├── public/
│   ├── package.json
│   └── ...
├── backend/               # Express backend API
│   ├── src/
│   ├── package.json
│   ├── .env               # Generate your own
│   ├── .env.example
│   └── ...
├── docs/                  # Documentation
├── .github/               # GitHub templates and workflows
├── package.json           # Root package.json (workspace)
├── README.md             # This file
└── ...

🔧 Development

Available Scripts

  • npm run dev - Start both frontend and backend in development mode
  • npm run build - Build both applications for production
  • npm run start - Start the production server
  • npm run format - Format code with Prettier

Environment Variables

Create a .env file in the root directory:

# Backend Configuration
PORT=5000
NODE_ENV=development
MONGODB_URL= for local use: (mongodb://localhost:27017/ogv)

# Optional: Add any API keys for enhanced features
# SOME_API_KEY=your_api_key_here
# Remember to always update .env.example if adding new env var
# And relay the env through secure channels to project owner or report the source to secure one

🤝 Contributing

We welcome contributions from the community! Please read our Contributing Guide to get started.

Quick Contribution Steps

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes
  4. Run tests and ensure code quality (npm run lint && npm run test)
  5. Commit your changes (git commit -m 'Add amazing feature')
  6. Push to the branch (git push origin feature/amazing-feature)
  7. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

🌟 Acknowledgments

  • Thanks to all contributors who help make this project better
  • Inspired by the need for better social media optimization tools
  • Built with amazing open source technologies

📊 Project Status

GitHub issues GitHub pull requests GitHub stars GitHub license


Made with ❤️ by Your Name

About

No description, website, or topics provided.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published