{"id":28825654,"url":"https://github.com/iwatkot/maps4fsui","last_synced_at":"2026-04-03T08:03:13.828Z","repository":{"id":333519307,"uuid":"1038677957","full_name":"iwatkot/maps4fsui","owner":"iwatkot","description":"Web interface for the Maps4FS - app to generate maps for Farming Simualtor using real-world data.","archived":false,"fork":false,"pushed_at":"2026-03-17T21:07:49.000Z","size":1507,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-18T11:43:41.881Z","etag":null,"topics":["dem","dtm","farming-simulator","javascript","leaflet","maps4fs","nextjs","openstreetmap","osm"],"latest_commit_sha":null,"homepage":"https://maps4fs.xyz","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iwatkot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-15T16:22:51.000Z","updated_at":"2026-03-17T21:07:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/iwatkot/maps4fsui","commit_stats":null,"previous_names":["iwatkot/maps4fsui"],"tags_count":160,"template":false,"template_full_name":null,"purl":"pkg:github/iwatkot/maps4fsui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iwatkot%2Fmaps4fsui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iwatkot%2Fmaps4fsui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iwatkot%2Fmaps4fsui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iwatkot%2Fmaps4fsui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iwatkot","download_url":"https://codeload.github.com/iwatkot/maps4fsui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iwatkot%2Fmaps4fsui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31342742,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T06:57:30.245Z","status":"ssl_error","status_checked_at":"2026-04-03T06:57:29.849Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dem","dtm","farming-simulator","javascript","leaflet","maps4fs","nextjs","openstreetmap","osm"],"created_at":"2025-06-19T02:05:12.618Z","updated_at":"2026-04-03T08:03:13.792Z","avatar_url":"https://github.com/iwatkot.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\" markdown\u003e\n\n[![Maps4FS](https://img.shields.io/badge/maps4fs-gray?style=for-the-badge)](https://github.com/iwatkot/maps4fs)\n[![Maps4FS](https://img.shields.io/badge/atlasfs-green?style=for-the-badge)](https://github.com/iwatkot/atlasfs)\n[![Maps4FS](https://img.shields.io/badge/maps4fs-windows-purple?style=for-the-badge)](https://github.com/iwatkot/maps4fswindows)\n[![PYDTMDL](https://img.shields.io/badge/pydtmdl-blue?style=for-the-badge)](https://github.com/iwatkot/pydtmdl)\n[![PYGDMDL](https://img.shields.io/badge/pygmdl-teal?style=for-the-badge)](https://github.com/iwatkot/pygmdl)  \n[![Maps4FS API](https://img.shields.io/badge/maps4fs-api-green?style=for-the-badge)](https://github.com/iwatkot/maps4fsapi)\n[![Maps4FS UI](https://img.shields.io/badge/maps4fs-ui-blue?style=for-the-badge)](https://github.com/iwatkot/maps4fsui)\n[![Maps4FS Data](https://img.shields.io/badge/maps4fs-data-orange?style=for-the-badge)](https://github.com/iwatkot/maps4fsdata)\n[![Maps4FS ChromaDocs](https://img.shields.io/badge/maps4fs-chromadocs-orange?style=for-the-badge)](https://github.com/iwatkot/maps4fschromadocs)  \n[![Maps4FS Upgrader](https://img.shields.io/badge/maps4fs-upgrader-yellow?style=for-the-badge)](https://github.com/iwatkot/maps4fsupgrader)\n[![Maps4FS Stats](https://img.shields.io/badge/maps4fs-stats-red?style=for-the-badge)](https://github.com/iwatkot/maps4fsstats)\n[![Maps4FS Bot](https://img.shields.io/badge/maps4fs-bot-teal?style=for-the-badge)](https://github.com/iwatkot/maps4fsbot)\n[![Maps4FS Locale](https://img.shields.io/badge/maps4fs-locale-purple?style=for-the-badge)](https://github.com/iwatkot/maps4fslocale)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\" markdown\u003e\n\n\u003cimg src=\"https://github.com/iwatkot/maps4fsui/releases/download/2.9.53.5/ui-1280-640.png\"\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"#maps4fs\"\u003eMaps4FS\u003c/a\u003e •\n    \u003ca href=\"#overview\"\u003eOverview\u003c/a\u003e\n\u003c/p\u003e\n\n[![Join Discord](https://img.shields.io/badge/join-discord-blue)](https://discord.gg/wemVfUUFRA)\n[![Docker Pulls](https://img.shields.io/docker/pulls/iwatkot/maps4fsui)](https://hub.docker.com/r/iwatkot/maps4fsui)\n[![Docker Image Size](https://img.shields.io/docker/image-size/iwatkot/maps4fsui)](https://hub.docker.com/r/iwatkot/maps4fsui)\n[![Docker Version](https://img.shields.io/docker/v/iwatkot/maps4fsui)](https://hub.docker.com/r/iwatkot/maps4fsui)\n\u003cbr\u003e\n[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/iwatkot/maps4fsui)](https://github.com/iwatkot/maps4fsui/releases)\n[![GitHub issues](https://img.shields.io/github/issues/iwatkot/maps4fsui)](https://github.com/iwatkot/maps4fsui/issues)\n[![GitHub Repo stars](https://img.shields.io/github/stars/iwatkot/maps4fsui)](https://github.com/iwatkot/maps4fsui/stargazers)\n\n\u003c/div\u003e\n\n# Maps4FS UI\n\nA modern web interface for generating custom Farming Simulator maps using real-world data. This Next.js application provides an intuitive way to create maps for Farming Simulator 22 and 25 games with customizable terrain, textures, and geographic features.\n\n## Features\n\n### 🗺️ Map Generation\n- **Real-world terrain**: Generate maps based on actual geographic locations using coordinates\n- **Multiple map sizes**: Support for 2048x2048 to 16384x16384 meter maps with custom sizing\n- **Multiple games**: Compatible with Farming Simulator 22 and 25\n- **Rotation support**: Rotate maps to align with desired orientations\n\n### 🌍 Data Sources\n- **Public DTM providers**: Global elevation data from SRTM and other sources\n- **Custom OSM files**: Upload your own OpenStreetMap data for specialized areas\n- **Multiple resolution options**: Choose from various elevation data resolutions\n\n### 🎨 Customization Options\n- **Terrain modification**: Adjust water depth, add foundations, create plateaus\n- **Background generation**: Generate custom backgrounds with water features\n- **Texture schemas**: Create and edit custom texture mappings\n- **Tree schemas**: Define custom vegetation patterns\n\n### 📊 Map Management\n- **My Maps**: Browse and manage your generated maps\n- **Preview gallery**: View map previews including terrain, satellite imagery, and textures\n- **Map duplication**: Clone existing maps with modified settings\n- **Download management**: Export completed maps for use in Farming Simulator\n\n### ⚙️ Advanced Settings\n- **DEM configuration**: Fine-tune elevation model processing\n- **Texture settings**: Customize material and texture generation\n- **I3D settings**: Configure 3D model export parameters\n- **Satellite imagery**: Integrate aerial photography data\n\n## Technology Stack\n\n- **Frontend**: Next.js 15 with React 19\n- **Styling**: Tailwind CSS 4\n- **3D Visualization**: Three.js with React Three Fiber\n- **Maps**: Leaflet with React Leaflet\n- **Data Processing**: OSM to GeoJSON conversion\n- **File Handling**: Archive creation and management\n\n## Getting Started\n\n### Prerequisites\n- Node.js 18+ \n- A running Maps4FS backend service\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/iwatkot/maps4fsuib.git\ncd maps4fsuib\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Configure environment variables:\n```bash\ncp .env.example .env.local\n# Edit .env.local with your backend URL and other settings\n```\n\n4. Start the development server:\n```bash\nnpm run dev\n```\n\n5. Open [http://localhost:3000](http://localhost:3000) in your browser\n\n### Environment Variables\n\n- `NEXT_PUBLIC_BACKEND_URL`: URL of the Maps4FS backend service\n- `NEXT_PUBLIC_APP_ENV`: Application environment (maps4fs for public version)\n- `NEXT_PUBLIC_BEARER_TOKEN`: Authentication token for backend requests\n- `NEXT_PUBLIC_MFS_ROOT_DIR`: Root directory for map storage\n\n## Docker Deployment\n\n### Using Docker Compose\n```bash\ndocker-compose up -d\n```\n\n### Building Docker Image\n```bash\ndocker build -t maps4fsui .\ndocker run -p 3000:3000 maps4fsui\n```\n\n## Project Structure\n\n- `/src/app` - Next.js app router pages and layouts\n- `/src/components` - Reusable React components\n- `/src/hooks` - Custom React hooks for API integration\n- `/src/utils` - Utility functions and helpers\n- `/src/config` - Configuration files and validation schemas\n- `/public` - Static assets and files\n\n## Contributing\n\nThis repository is part of the larger Maps4FS ecosystem. For contribution guidelines and project information, please refer to the [main Maps4FS repository](https://github.com/iwatkot/maps4fs).\n\n## Related Projects\n\n- [maps4fs](https://github.com/iwatkot/maps4fs) - Core Python library\n- [maps4fsapi](https://github.com/iwatkot/maps4fsapi) - Backend API service\n- [maps4fsdata](https://github.com/iwatkot/maps4fsdata) - Data processing tools\n- [maps4fsstats](https://github.com/iwatkot/maps4fsstats) - Usage statistics\n- [maps4fsbot](https://github.com/iwatkot/maps4fsbot) - Discord bot integration\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiwatkot%2Fmaps4fsui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiwatkot%2Fmaps4fsui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiwatkot%2Fmaps4fsui/lists"}