A mobile-first Progressive Web App for discovering authentic places and sharing experiences.
- 📱 PWA Support - Install as a native app on mobile devices
- 🗺️ Google Maps Integration - Discover nearby places and attractions
- 📸 Photo Sharing - Share your experiences with beautiful photos
- 🌙 Dark Theme - Modern dark UI design
- 📍 Location Services - Find places near you
- 🔍 Place Search - Search for specific locations
- 💬 Social Features - Like, comment, and share posts
git clone <your-repo-url>
cd SYNCSHACK2025-
Copy the example configuration file:
cp config.example.js config.js
-
Get a Google Maps API Key:
- Go to Google Cloud Console
- Create a new project or select an existing one
- Enable the following APIs:
- Maps JavaScript API
- Places API
- Go to "Credentials" and create an API Key
- (Optional) Restrict the API key to your domain for security
-
Edit
config.jsand replaceYOUR_GOOGLE_MAPS_API_KEY_HEREwith your actual API key:GOOGLE_MAPS_API_KEY: 'your_actual_api_key_here',
Simply open index.html in a web browser, or serve it using a local server:
# Using Python
python -m http.server 8000
# Using Node.js (if you have http-server installed)
npx http-server
# Using PHP
php -S localhost:8000On mobile devices:
- iOS: Open in Safari → Share → Add to Home Screen
- Android: Open in Chrome → Menu → Add to Home Screen
SYNCSHACK2025/
├── index.html # Main HTML file
├── styles.css # Stylesheet
├── script.js # JavaScript functionality
├── manifest.json # PWA manifest
├── sw.js # Service worker
├── config.js # API keys (not in git)
├── config.example.js # Template for API keys
├── .gitignore # Git ignore rules
└── README.md # This file
config.jsis excluded from version control via.gitignore- Never commit API keys to your repository
- Consider restricting your Google Maps API key to specific domains
- The
config.example.jsfile serves as a template for other developers
The app uses vanilla JavaScript, HTML5, and CSS3. No build process is required.
Add new API keys to the CONFIG object in config.js:
const CONFIG = {
GOOGLE_MAPS_API_KEY: 'your_key_here',
NEW_API_KEY: 'another_key_here',
// ...
};Modify the default map location and zoom in config.js:
DEFAULT_MAP_CENTER: {
lat: your_latitude,
lng: your_longitude
},
DEFAULT_MAP_ZOOM: your_preferred_zoom_level[Add your license here]
[Add contribution guidelines here]