A decentralized, open-source travel directory built entirely on GitHub.

Vote Manager

Git Guide is a community-curated travel directory that uses GitHub as both the frontend and backend. No databases, no servers - just Markdown files and GitHub Actions!

Key Features:

• 🗳️ Community Voting - Places are added based on community consensus
• 🤖 Fully Automated - Bot handles all file creation and indexing
• 📁 Git-based CMS - All data stored as Markdown files
• 🌐 Open Source - Transparent, forkable, and self-hostable

flowchart TB
    subgraph User["👤 User"]
        A[Opens Issue]
        B[Fills YAML Form]
    end
    
    subgraph Community["👥 Community"]
        C[Votes with 👍/👎]
    end
    
    subgraph Mod["🛡️ Moderator"]
        D[Reviews Proposal]
        E[Adds 'mod-approved' Label]
    end
    
    subgraph Bot["🤖 GitHub Actions"]
        F[Checks Vote Threshold]
        G[Validates City via geopy]
        H[Creates Markdown File]
        I[Updates Index Files]
        J[Closes Issue]
    end
    
    A --> B --> C --> D --> E --> F
    F -->|≥100 votes| G --> H --> I --> J
    F -->|<100 votes| K[Waits for more votes]

→ Browse All Countries

1. Open a new Issue and select "📍 Propose a Place"
2. Fill out the form with place details
3. Wait for community votes (👍 / 👎)
4. Once approved by moderators, the bot adds it automatically!

1. Browse open proposals
2. React with 👍 to support or 👎 to oppose
3. Your vote counts toward the 100-vote threshold

All guide data is stored as Markdown files in a strict hierarchy:

countries/
├── README.md                    # Index of all countries
├── Italy/
│   ├── README.md                # Index of Italian cities
│   ├── Rome/
│   │   ├── README.md            # Index of Rome places
│   │   ├── Eat/
│   │   │   └── trattoria_da_mario.md
│   │   └── See/
│   │       └── colosseum.md
│   └── Florence/
│       └── ...
└── Japan/
    └── Tokyo/
        └── ...

A place is accepted when:

net_votes = thumbs_up - thumbs_down
accepted = net_votes >= 100 AND mod_approved == true

• ⏰ Scheduled: Every 6 hours
• 🏷️ On Label: When mod-approved is added
• 🖱️ Manual: Via workflow dispatch

See CONTRIBUTING.md for detailed guidelines.

Quick Links:

• Propose a Place
• View Open Proposals
• Start a Discussion

Built with ❤️ using IssueOps
_{No databases. No servers. Just Git.}