Image Storage

Asset-first repository for hosting, versioning, and serving reusable image resources.

Note

Project structure below is auto-generated on every push via update-readme.yml

Table of Contents

• Features
• Technology Stack
• Technical Block
  • Project Structure
  • Key Design Decisions
• Usage
• License

Features

• Centralized storage for static image assets used across projects.
• Git-based versioning for deterministic asset history and rollback.
• Lightweight structure with predictable paths for direct raw-content linking.
• Ready-to-use files for web pages and external embedding.
• License clarity via an included MIT license file.

Tip

Keep binary filenames stable once published to avoid breaking external links.

Technology Stack

• Core format: static binary assets (.png) and lightweight docs (.md).
• Delivery model: GitHub repository + raw.githubusercontent.com direct asset URLs.
• Markup: HTML (for in-repo preview/demo via index.html) and Markdown for docs.
• Version control: Git + GitHub workflow.

Technical Block

Project Structure

.
├── Factorio/
│   └── Gear-silhouette-of-the-Factorio-logo.png
├── adwmg/
│   └── pidpus-2.png
├── readme/
│   └── readme-SVG-Banned-words_contributing.png
│   └── readme-SVG-Banned-words_readme.png
│   └── readme-SVG-Banned-words_security.png
│   └── readme-SVG-Banned-words_сodeofсonduct.png
│   └── OstinUA_Looping_Donut-(1).gif
│   └── OstinUA_github_readme_v1.gif
│   └── OstinUA_github_readme_v1Donut.gif
│   └── OstinUA_github_readme_v1Donut.svg
│   └── OstinUA_github_readme_v2.gif
│   └── OstinUA_github_readme_v3.gif
│   └── OstinUA_github_readme_v4.gif
│   └── OstinUA_github_readme_v7.gif
├── index.html
├── LICENSE
└── README.md

📁 Factorio

Preview	File	Raw URL
	Gear-silhouette-of-the-Factorio-logo.png	link

📁 adwmg

Preview	File	Raw URL
	pidpus-2.png	link

📁 readme

Preview	File	Raw URL
	OstinUA_Looping_Donut-(1).gif	link
	OstinUA_github_readme_v1.gif	link
	OstinUA_github_readme_v1Donut.gif	link
	OstinUA_github_readme_v1Donut.svg	link
	OstinUA_github_readme_v2.gif	link
	OstinUA_github_readme_v3.gif	link
	OstinUA_github_readme_v4.gif	link
	OstinUA_github_readme_v7.gif	link

📁 readme/Banned-words

Preview	File	Raw URL
	readme-SVG-Banned-words_contributing.png	link
	readme-SVG-Banned-words_readme.png	link
	readme-SVG-Banned-words_security.png	link
	readme-SVG-Banned-words_сodeofсonduct.png	link

Key Design Decisions

1. Flat and explicit storage layout Assets are grouped in simple directories to keep paths human-readable and predictable.

2. No runtime dependency surface The repository intentionally avoids backend services, build steps, or package managers.

3. Raw-link friendly strategy Files are stored in a way that supports direct consumption through GitHub raw links for quick integrations.

4. Documentation-first maintainability The README defines structure, usage expectations, and operational guardrails.

Important

If this repository is used as a public CDN-like source, treat path changes as breaking changes.

Warning

Do not rewrite image history aggressively in shared branches (git push --force) if downstream systems depend on commit-pinned asset URLs.

Usage

Use a direct raw URL pattern for any stored image:

https://raw.githubusercontent.com/<owner>/<repo>/<branch>/<path-to-image>

Example from this repo:

https://raw.githubusercontent.com/OstinUA/Image-storage/main/adwmg/pidpus-2.png

Caution

Prefer branch protection and reviewed PRs before replacing existing public assets.

License

This project is distributed under the MIT license. See LICENSE for details.