Skip to content

Commit 1bdca4a

Browse files
ManuelGilManuelGil
committed
feat: add gallery page showcasing Amonite system screenshots
- Introduced a new gallery page to display various screenshots of the Amonite system as shipped, including first boot, terminal, welcome handbook, installer, and everyday tools. - Updated the index page to include a link to the new gallery. - Enhanced the layout and structure of the index page with new screenshots and descriptions. - Refactored the philosophy page to improve content organization and presentation. - Updated privacy and terms pages to use a consistent PageHeader component for better styling. - Added a new CSS class for monospace labels to improve text clarity in specific contexts.
1 parent 3ff4830 commit 1bdca4a

42 files changed

Lines changed: 1003 additions & 804 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎AGENTS.md‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
# AGENTS.md
22

3-
**Owns:** how to work in this website repository.
3+
**Owns:** how to work in this website repository.
44
**Does not own:** distribution product definition (that is external, and public narrative lives on the site).
55

66
Read [`docs/INVARIANTS.md`](docs/INVARIANTS.md) before changing architecture, IA, or docs ownership.
77

8-
| Need | Read |
9-
| --- | --- |
10-
| Repo overview | `README.md` |
11-
| Contracts | `docs/INVARIANTS.md` |
12-
| Structure / deploy | `docs/WEBSITE_GUIDE.md` |
13-
| Copy | `docs/EDITORIAL.md` |
14-
| Look | `docs/VISUAL.md`, `docs/ASSETS.md` |
8+
| Need | Read |
9+
| ------------------ | ---------------------------------- |
10+
| Repo overview | `README.md` |
11+
| Contracts | `docs/INVARIANTS.md` |
12+
| Structure / deploy | `docs/WEBSITE_GUIDE.md` |
13+
| Copy | `docs/EDITORIAL.md` |
14+
| Look | `docs/VISUAL.md`, `docs/ASSETS.md` |
1515

1616
Facts on pages come from `src/data/distribution.ts` (content, not website versioning).
1717

‎ATTRIBUTION.md‎

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22

33
## Ownership
44

5-
| | |
6-
| --- | --- |
7-
| **Purpose** | Record third-party asset licensing for this repository |
8-
| **Audience** | Maintainers and anyone redistributing assets |
9-
| **Owns** | Third-party image and font attribution / license references |
5+
| | |
6+
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
7+
| **Purpose** | Record third-party asset licensing for this repository |
8+
| **Audience** | Maintainers and anyone redistributing assets |
9+
| **Owns** | Third-party image and font attribution / license references |
1010
| **Does not own** | Asset semantics ([docs/ASSETS.md](docs/ASSETS.md)); visual rules ([docs/VISUAL.md](docs/VISUAL.md)); whether an asset is currently used in UI |
11-
| **Dependencies** | [`docs/ASSETS.md`](docs/ASSETS.md) · `LICENSE` |
11+
| **Dependencies** | [`docs/ASSETS.md`](docs/ASSETS.md) · `LICENSE` |
1212

1313
**Contract:** Licensing reference. Filenames here do not define architecture or usage.
1414

@@ -39,6 +39,12 @@ All photographs remain subject to the Unsplash License.
3939

4040
https://unsplash.com/license
4141

42+
## Screenshots
43+
44+
Files under `src/assets/screenshots/` are first-party captures of the Amonite
45+
operating system produced by the project. They are not third-party assets and
46+
are covered by the repository's own licensing.
47+
4248
## Fonts
4349

4450
This project includes the Inter typeface.

‎README.md‎

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -19,20 +19,20 @@ pnpm preview
1919
```
2020

2121
Astro 7 · Tailwind 4 · GitHub Pages.
22-
Release and capability facts: `src/data/distribution.ts`.
22+
Release and capability facts: `src/data/distribution.ts`.
2323
Tokens: `src/styles/global.css`.
2424

2525
## Maintainer docs
2626

27-
| File | Purpose |
28-
| --- | --- |
29-
| [`AGENTS.md`](AGENTS.md) | How to work in this repo |
30-
| [`docs/INVARIANTS.md`](docs/INVARIANTS.md) | Contracts |
31-
| [`docs/WEBSITE_GUIDE.md`](docs/WEBSITE_GUIDE.md) | IA and deploy |
32-
| [`docs/EDITORIAL.md`](docs/EDITORIAL.md) | Public copy rules |
33-
| [`docs/VISUAL.md`](docs/VISUAL.md) | Visual system |
34-
| [`docs/ASSETS.md`](docs/ASSETS.md) | Asset catalog |
35-
| [`ATTRIBUTION.md`](ATTRIBUTION.md) / [`SECURITY.md`](SECURITY.md) / [`LICENSE`](LICENSE) | Legal |
27+
| File | Purpose |
28+
| ---------------------------------------------------------------------------------------- | ------------------------ |
29+
| [`AGENTS.md`](AGENTS.md) | How to work in this repo |
30+
| [`docs/INVARIANTS.md`](docs/INVARIANTS.md) | Contracts |
31+
| [`docs/WEBSITE_GUIDE.md`](docs/WEBSITE_GUIDE.md) | IA and deploy |
32+
| [`docs/EDITORIAL.md`](docs/EDITORIAL.md) | Public copy rules |
33+
| [`docs/VISUAL.md`](docs/VISUAL.md) | Visual system |
34+
| [`docs/ASSETS.md`](docs/ASSETS.md) | Asset catalog |
35+
| [`ATTRIBUTION.md`](ATTRIBUTION.md) / [`SECURITY.md`](SECURITY.md) / [`LICENSE`](LICENSE) | Legal |
3636

3737
## License
3838

‎SECURITY.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Security Policy
22

3-
**Scope:** this website repository only.
3+
**Scope:** this website repository only.
44
**Not in scope:** the Amonite GNU/Linux distribution (use that project's channels).
55

66
## Reporting

‎docs/ASSETS.md‎

Lines changed: 40 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,55 @@
11
# Asset catalog
22

3-
**Audience:** maintainers.
4-
**Owns:** why assets exist and how they may be used.
5-
**Licensing:** [`ATTRIBUTION.md`](../ATTRIBUTION.md).
3+
**Audience:** maintainers.
4+
**Owns:** why assets exist and how they may be used.
5+
**Licensing:** [`ATTRIBUTION.md`](../ATTRIBUTION.md).
66
**Visual rules:** [VISUAL.md](VISUAL.md).
77

88
Do not remove assets because they are currently unreferenced. Filenames are themes, not routes.
99

1010
## Marks
1111

12-
| Asset | Role |
13-
| --- | --- |
14-
| `src/assets/logo.png` | Canonical logo |
15-
| `public/logo.png`, `public/logo.pbm` | Public copies |
12+
| Asset | Role |
13+
| ----------------------------------------------------- | -------------- |
14+
| `src/assets/logo.png` | Canonical logo |
15+
| `public/logo.png`, `public/logo.pbm` | Public copies |
1616
| `public/favicon.*`, sized PNGs, Apple / Android icons | Favicon family |
1717

18+
## Screenshots (`src/assets/screenshots/`)
19+
20+
Primary imagery. Every file is an unedited capture of the released system
21+
(window images are cropped to the window; nothing is retouched). Captured from
22+
the live ISO on the validated QEMU/KVM configuration. Recapture when a release
23+
visibly changes the UI; never mock or composite.
24+
25+
| File | Shows |
26+
| -------------------------- | ----------------------------------------------- |
27+
| `first-boot.png` | Live session at first boot: Welcome + installer |
28+
| `terminal-fastfetch.png` | Maximized terminal, fastfetch system report |
29+
| `welcome-handbook.png` | Welcome app, Welcome page |
30+
| `welcome-your-system.png` | Welcome app, Your System page |
31+
| `installer-partitions.png` | Calamares partitioning step |
32+
| `file-manager.png` | Thunar |
33+
| `settings-manager.png` | XFCE Settings Manager |
34+
| `applications-menu.png` | Applications menu over the bare desktop |
35+
1836
## Photography (`src/assets/img/`)
1937

20-
| File | Theme |
21-
| --- | --- |
22-
| `hero.jpg` | Geology / permanence |
23-
| `philosophy.jpg` | Geology |
24-
| `texture.jpg` | Geology / material |
25-
| `engineering.jpg` | Engineering |
26-
| `transparency.jpg` | Clarity / structure |
27-
| `observability.jpg` | Systems in view |
28-
| `security.jpg` | Trust (never fear) |
29-
| `workspace.jpg` | Productive work |
38+
Curated supporting imagery. Use selected images to introduce a chapter, create
39+
a pause, or reinforce atmosphere. Screenshots remain the primary representation
40+
of the operating system; photography must not become decoration or replace
41+
product evidence.
42+
43+
| File | Theme |
44+
| ------------------- | -------------------- |
45+
| `hero.jpg` | Geology / permanence |
46+
| `philosophy.jpg` | Geology |
47+
| `texture.jpg` | Geology / material |
48+
| `engineering.jpg` | Engineering |
49+
| `transparency.jpg` | Clarity / structure |
50+
| `observability.jpg` | Systems in view |
51+
| `security.jpg` | Trust (never fear) |
52+
| `workspace.jpg` | Productive work |
3053

3154
Interchangeable within theme. Not disposable.
3255

‎docs/EDITORIAL.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Editorial guide
22

3-
**Audience:** maintainers editing public copy.
3+
**Audience:** maintainers editing public copy.
44
**Does not own:** product facts (use `src/data/distribution.ts`) or visual tokens (`docs/VISUAL.md`).
55

66
## Voice

‎docs/INVARIANTS.md‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Repository invariants
22

3-
**Audience:** maintainers and contributors.
3+
**Audience:** maintainers and contributors.
44
**Does not own:** public product narrative (that lives on the website).
55

66
The website at [amonite.org](https://amonite.org) is the public source of truth for product identity, philosophy, capabilities, downloads, release presentation, and community.
@@ -9,17 +9,17 @@ Repository docs exist only to help people build, maintain, or contribute to this
99

1010
## Sources of truth
1111

12-
| Concept | Location |
13-
| --- | --- |
14-
| Public product | Website (`src/pages`, `src/data/distribution.ts`) |
15-
| This repo | `README.md` |
16-
| Contracts | `docs/INVARIANTS.md` |
17-
| Structure & deploy | `docs/WEBSITE_GUIDE.md` |
18-
| Writing for the site | `docs/EDITORIAL.md` |
19-
| Visual system | `docs/VISUAL.md`, `docs/ASSETS.md`, `src/styles/global.css` |
20-
| Contribution | `AGENTS.md` |
21-
| Legal / security | `ATTRIBUTION.md`, `SECURITY.md`, `LICENSE` |
22-
| Distribution project | https://github.com/ManuelGil/amonite |
12+
| Concept | Location |
13+
| -------------------- | ----------------------------------------------------------- |
14+
| Public product | Website (`src/pages`, `src/data/distribution.ts`) |
15+
| This repo | `README.md` |
16+
| Contracts | `docs/INVARIANTS.md` |
17+
| Structure & deploy | `docs/WEBSITE_GUIDE.md` |
18+
| Writing for the site | `docs/EDITORIAL.md` |
19+
| Visual system | `docs/VISUAL.md`, `docs/ASSETS.md`, `src/styles/global.css` |
20+
| Contribution | `AGENTS.md` |
21+
| Legal / security | `ATTRIBUTION.md`, `SECURITY.md`, `LICENSE` |
22+
| Distribution project | https://github.com/ManuelGil/amonite |
2323

2424
## Invariants
2525

‎docs/VISUAL.md‎

Lines changed: 26 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Visual system
22

3-
**Audience:** maintainers and designers.
4-
**Owns:** visual identity and token intent for this website.
5-
**Does not own:** public product narrative.
3+
**Audience:** maintainers and designers.
4+
**Owns:** visual identity and token intent for this website.
5+
**Does not own:** public product narrative.
66
**Implementation:** `src/styles/global.css`. Asset list: [ASSETS.md](ASSETS.md).
77

88
## Personality
@@ -17,32 +17,40 @@ Stylised ammonite. Official assets only (`src/assets/logo.png`, `public/` favico
1717

1818
Neutrals carry the UI. Amber is a sparse accent.
1919

20-
| Token | Value | Role |
21-
| --- | --- | --- |
22-
| amber / primary | `#C08A2B` | Accent, links |
23-
| stone | `#8B8B4A` | Rare earth accent |
24-
| sand | `#DBC3A5` | Soft panels |
25-
| mist | `#ECEBE1` | Default background |
26-
| slate | `#4A4F57` | Muted text, borders |
27-
| graphite | `#34373D` | Primary text; dark surfaces |
28-
| deep-green | `#3D5A40` | Occasional natural accent |
20+
| Token | Value | Role |
21+
| --------------- | --------- | --------------------------- |
22+
| amber / primary | `#C08A2B` | Accent, links |
23+
| stone | `#8B8B4A` | Rare earth accent |
24+
| sand | `#DBC3A5` | Soft panels |
25+
| mist | `#ECEBE1` | Default background |
26+
| slate | `#4A4F57` | Muted text, borders |
27+
| graphite | `#34373D` | Primary text; dark surfaces |
28+
| deep-green | `#3D5A40` | Occasional natural accent |
2929

3030
No saturated blues, purples, neon, or glow chrome.
3131

3232
## Typography
3333

34-
| Role | Family |
35-
| --- | --- |
36-
| UI and body | Inter |
37-
| Rare display lines | Classical serif (`.display-serif`) |
34+
| Role | Family |
35+
| ------------------ | --------------------------------------------------------------------------------------------------- |
36+
| UI and body | Inter |
37+
| Rare display lines | Classical serif (`.display-serif`) |
38+
| System voice | Monospace (`--font-mono`, `.label-mono`): section markers, spec values, filenames, terminal content |
3839

3940
## Spacing and radius
4041

4142
Base unit 4px. Prefer generous editorial gaps between sections. Radii stay small (`0.125rem`–`0.5rem`). Flat surfaces; borders over shadows.
4243

43-
## Photography
44+
## Imagery
4445

45-
Editorial, muted, meaningful. Themes: geology, engineering, trust, productive environments. Filenames are themes, not routes. Do not delete curated assets without explicit instruction.
46+
The operating system is the imagery. Screenshots are unedited captures of the
47+
released system (`docs/ASSETS.md`); present them flat, bordered, and captioned
48+
like documentation figures. No mockups, no device frames, no composites.
49+
50+
Curated photography under `src/assets/img/` may introduce a chapter, create a
51+
pause, or reinforce atmosphere. Screenshots remain the primary representation
52+
of the operating system. Do not use photography as decoration or as a
53+
replacement for product evidence.
4654

4755
## Avoid
4856

‎docs/WEBSITE_GUIDE.md‎

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,22 @@
11
# Website guide
22

3-
**Audience:** maintainers.
4-
**Owns:** IA map, content workflow, deploy.
3+
**Audience:** maintainers.
4+
**Owns:** IA map, content workflow, deploy.
55
**Does not own:** public product copy (edit pages and `distribution.ts` instead).
66

77
## Surfaces
88

9-
| Path | Maintainer role |
10-
| --- | --- |
11-
| `/` | Introduction; points into the rest of the site |
12-
| `/philosophy` | Selection principles |
13-
| `/engineering` | Capabilities and how they are realized |
14-
| `/community` | Reddit + GitHub |
15-
| `/downloads` | Artifacts and verification |
16-
| `/privacy`, `/terms` | Legal |
17-
18-
Nav: Philosophy · Engineering · Community · Downloads (plus Download CTA).
9+
| Path | Maintainer role |
10+
| -------------------- | ---------------------------------------------- |
11+
| `/` | Introduction; points into the rest of the site |
12+
| `/philosophy` | Selection principles |
13+
| `/engineering` | Capabilities and how they are realized |
14+
| `/gallery` | Unedited captures of the released system |
15+
| `/community` | Reddit + GitHub |
16+
| `/downloads` | Artifacts and verification |
17+
| `/privacy`, `/terms` | Legal |
18+
19+
Nav: Philosophy · Engineering · Gallery · Community · Downloads (plus Download CTA).
1920

2021
## Content workflow
2122

‎public/llms.txt‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ Amonite is an independent distribution maintained by Manuel Gil. Every package s
99
- [Home](https://amonite.org/): What Amonite is and what becomes possible after install.
1010
- [Philosophy](https://amonite.org/philosophy): Why Amonite exists and the selection principle behind every included package.
1111
- [Engineering](https://amonite.org/engineering): How capabilities (desktop, development, administration, security, networking, local AI) are implemented, and what stays replaceable.
12+
- [Gallery](https://amonite.org/gallery): Unedited screenshots of the released system: first boot, terminal, welcome handbook, installer, and everyday tools.
1213
- [Downloads](https://amonite.org/downloads): ISO, SHA256 checksum, GPG signature, release notes, and installation guide for the current release.
1314
- [Community](https://amonite.org/community): Reddit (r/amonite) for discussion, GitHub for releases and documentation.
1415

0 commit comments

Comments
 (0)