Memory Map

Memory Map is a location-aware media archive that allows users to upload photos, videos, and audio files.

The list of supported file types is defined in the allowed files list.

Time and location metadata are manually provided by users and are used to visualise uploaded media on an interactive world map.

Users can browse the map, click markers and explore media galleries tied to real-world locations - creating a digital memory atlas.

Features

• Upload media files (images, videos and audio files).
• Manual location & timestamp tagging.
• Interactive world map with clickable memory pins.
• Gallery view for each map location.

Screenshots

Map View

Gallery View

Admin View

GraphQL API (GraphiQL)

Getting Started

1. Install dependencies

You'll need:

• Nix Package Manager
• nix-direnv

2. Clone & enter project (you only need to do this step once)

git clone https://github.com/nothingnesses/memory-map.git
cd memory-map

3. Setup environment (you only need to do this step once)

cp .env.example .env
direnv allow

This installs all dependencies and auto-loads the development shell whenever you enter the directory.

You can optionally configure the build mode and other settings by editing .env:

• BUILD_MODE="debug" (default): Faster compilation, includes debug info.
• BUILD_MODE="release": Optimised build, smaller binaries, slower compilation.
• Database, SMTP, and S3 storage configurations.

4. Start database & storage

just servers

MinIO object storage becomes available at: http://localhost:9001/login

• Username: minioadmin
• Password: minioadmin

5. Start backend

In another shell, run:

just backend

Backend GraphQL playground: http://localhost:8000/

6. Start frontend

In another shell, run:

just frontend

Frontend app: http://localhost:3000/

Development Commands

The project uses Just as a task runner.

• just servers: Start PostgreSQL and MinIO via Nix.
• just backend: Start the Axum backend with hot-reloading (via Bacon).
• just frontend: Start the Leptos frontend (via Trunk).
• just fmt: Format Rust, Nix, Markdown, YAML, and TOML files.
• just check: Run cargo check for the workspace.
• just clippy: Run Clippy with warnings treated as errors.
• just deny: Check Rust dependencies with cargo-deny.
• just doc: Build documentation with warnings treated as errors and run ASCII/link checks.
• just test: Run the workspace test suite with cached output.
• just frontend-build: Build the frontend with Trunk.
• just verify: Run the full verification suite before submitting a PR.
• just regenerate-schema: Introspect the backend and update the frontend GraphQL schema.
• just scan-hardcoded: Scan the codebase for hardcoded secrets or values.

Tech Stack

Layer	Technology
Frontend	Leptos
	UnoCSS
Backend	Axum
	GraphQL
Storage	MinIO
Database	PostgreSQL
Development Environment	Nix package manager
	nix-direnv
Task Runner	Just

Project Structure

memory-map/
|-- .direnv/         # Direnv environment cache
|-- backend/         # Axum and GraphQL backend
|-- data/            # Database and storage volumes
|-- devenv/          # Nix development environment
|-- frontend/        # Leptos and UnoCSS frontend
|-- shared/          # Shared utilities and types
|-- .env.example     # Environment configuration template
|-- justfile         # Development commands
|-- Cargo.toml       # Rust workspace configuration
|-- Cargo.lock       # Rust dependency lock file
`-- README.md        # Project documentation

Contributing

We welcome contributions! Please ensure you run the verification suite before making a PR:

just verify

This command will:

• Format code and config
• Run workspace checks and Clippy
• Check dependency licenses and advisories
• Generate documentation
• Run tests
• Build the frontend

License

This project is licensed under the Blue Oak Model License 1.0.0.