feat: initialize LuminusOS wiki with guides and assets

- Add package.json for Astro configuration and dependencies.
- Create CNAME for custom domain wiki.luminusos.org.
- Include favicon and brand SVG assets for the wiki.
- Set up content configuration for documentation collections.
- Add multiple guides including installation, updates, apps, and contributing.
- Translate guides into Brazilian Portuguese.
- Implement custom CSS styles for the wiki theme.

Author: leandromqrs

.github/workflows/deploy-aurora.yml

@@ -0,0 +1,36 @@
+# Deploys the standalone aurora.luminusos.org variant of the site.
+#
+# GitHub Pages serves one site per repository, so the subdomain build is
+# pushed to the `gh-pages` branch of luminusOS/aurora-shell, which must have
+# Pages enabled and a DNS CNAME record: aurora.luminusos.org -> luminusos.github.io
+#
+# Requires a repo secret AURORA_DEPLOY_TOKEN: a fine-grained PAT with
+# "Contents: write" on luminusOS/aurora-shell.
+
+name: Deploy Aurora Shell site
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - run: npm ci
+      - run: npm run build:aurora
+
+      - uses: peaceiris/actions-gh-pages@v4
+        with:
+          personal_token: ${{ secrets.AURORA_DEPLOY_TOKEN }}
+          external_repository: luminusOS/aurora-shell
+          publish_branch: gh-pages
+          publish_dir: ./dist-aurora

.github/workflows/deploy-blog.yml

@@ -0,0 +1,37 @@
+# Builds the blog (a sub-project in blog/) and publishes it to the gh-pages
+# branch of luminusOS/blog, which serves blog.luminusos.org via GitHub Pages
+# (one Pages site per repo). Requires the BLOG_DEPLOY_TOKEN secret: a
+# fine-grained PAT with "Contents: write" on luminusOS/blog.
+
+name: Deploy blog site
+
+on:
+  push:
+    branches: [main]
+    paths: ['blog/**']
+  workflow_dispatch:
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: blog
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: blog/package-lock.json
+
+      - run: npm ci
+      - run: npm run build
+
+      - uses: peaceiris/actions-gh-pages@v4
+        with:
+          personal_token: ${{ secrets.BLOG_DEPLOY_TOKEN }}
+          external_repository: luminusOS/blog
+          publish_branch: gh-pages
+          publish_dir: ./blog/dist

.github/workflows/deploy-wiki.yml

@@ -0,0 +1,37 @@
+# Builds the wiki (a sub-project in wiki/) and publishes it to the gh-pages
+# branch of luminusOS/wiki, which serves wiki.luminusos.org via GitHub Pages
+# (one Pages site per repo). Requires the WIKI_DEPLOY_TOKEN secret: a
+# fine-grained PAT with "Contents: write" on luminusOS/wiki.
+
+name: Deploy wiki site
+
+on:
+  push:
+    branches: [main]
+    paths: ['wiki/**']
+  workflow_dispatch:
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: wiki
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: wiki/package-lock.json
+
+      - run: npm ci
+      - run: npm run build
+
+      - uses: peaceiris/actions-gh-pages@v4
+        with:
+          personal_token: ${{ secrets.WIKI_DEPLOY_TOKEN }}
+          external_repository: luminusOS/wiki
+          publish_branch: gh-pages
+          publish_dir: ./wiki/dist

.github/workflows/deploy.yml

@@ -0,0 +1,32 @@
+name: Deploy website to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: withastro/action@v3
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+dist-*/
+.astro/

README.md

@@ -1 +1,84 @@
-# luminos.github.io
+# LuminusOS Website
+
+The official website for [LuminusOS](https://luminusos.org), an immutable Linux
+distribution built on Fedora bootc, plus the [Aurora Shell](https://aurora.luminusos.org) subdomain variant, and
+the [wiki](https://wiki.luminusos.org) and [blog](https://blog.luminusos.org)
+as sub-projects in `wiki/` and `blog/`.
+
+Built with [Astro](https://astro.build). Fully static, no client framework;
+the only JavaScript on the page handles the theme toggle, the language menu
+and fetching the latest release tag from the GitHub API.
+
+## Pages & languages
+
+Every page exists in English (default) and Brazilian Portuguese:
+
+| Route | Content |
+| --- | --- |
+| `/` and `/pt-br/` | LuminusOS home: hero, pillars, how it works, editions, download, support |
+| `/aurora/` and `/pt-br/aurora/` | Aurora Shell subpage |
+
+All copy lives in a single typed dictionary: `src/i18n/translations.ts`.
+Adding a language = append it to the `languages` array (name + flag, the
+header menu picks it up automatically), add its entry to `translations`, and
+create the page folders for its prefix.
+
+The site has light and dark themes: dark by default, following the system
+preference, with a header toggle persisted in `localStorage`.
+
+## Development
+
+```sh
+npm install
+npm run dev      # http://localhost:4321
+npm run build    # static output in dist/
+npm run preview  # serve dist/ locally
+```
+
+## Downloads
+
+Download buttons point at
+`https://github.com/luminusOS/images/releases/latest`, which always resolves to
+the newest release, so no website change is needed when a release ships.
+Editions that don't exist yet (Play, Mobile, Tablet, Cast) render as locked
+"Coming soon" cards in `src/components/HomePage.astro`; flip one to available
+by editing the `available` check when its first release lands.
+
+## The Aurora Shell subdomain
+
+`aurora.luminusos.org` is a second build of this same project:
+
+```sh
+npm run build:aurora   # static output in dist-aurora/
+```
+
+With `SITE_VARIANT=aurora` the Aurora Shell page becomes the site root
+(`/` and `/pt-br/`), cross-links point back to `https://luminusos.org`, and
+`dist-aurora/CNAME` is written as `aurora.luminusos.org`.
+
+`deploy-aurora.yml` pushes that build to the `gh-pages` branch of
+`luminusOS/aurora-shell` (needs the `AURORA_DEPLOY_TOKEN` secret: a
+fine-grained PAT with Contents: write there), since GitHub Pages serves one
+site per repository.
+
+## Wiki & Blog (sub-projects)
+
+The wiki and the blog live in this repository as independent Astro projects:
+
+| Site | Folder | Stack |
+| --- | --- | --- |
+| [wiki.luminusos.org](https://wiki.luminusos.org) | `wiki/` | Astro Starlight (sidebar, search, i18n) |
+| [blog.luminusos.org](https://blog.luminusos.org) | `blog/` | Astro content collections, English + Google Translate menu |
+
+Each has its own `package.json` (`cd wiki && npm install && npm run dev`).
+GitHub Pages serves one site per repository, so `deploy-wiki.yml` and
+`deploy-blog.yml` build the sub-project and push its `dist/` to the
+`gh-pages` branch of `luminusOS/wiki` / `luminusOS/blog` (Pages-only repos).
+Setup per subdomain: create the target repo, enable Pages on `gh-pages`,
+point DNS `<sub>.luminusos.org` → `luminusos.github.io`, and add the
+`WIKI_DEPLOY_TOKEN` / `BLOG_DEPLOY_TOKEN` secret here (fine-grained PAT
+with Contents: write on the target repo).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

astro.config.mjs

@@ -0,0 +1,27 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+
+// SITE_VARIANT=aurora builds the standalone aurora.luminusos.org variant:
+// the Aurora Shell page becomes the site root and links back to the main
+// site. The wiki and blog are separate repositories.
+const variant = process.env.SITE_VARIANT ?? '';
+const sites = {
+  '': 'https://luminusos.org',
+  aurora: 'https://aurora.luminusos.org',
+};
+if (!(variant in sites)) {
+  throw new Error(`Unknown SITE_VARIANT "${variant}" (expected aurora)`);
+}
+
+export default defineConfig({
+  site: sites[/** @type {keyof typeof sites} */ (variant)],
+  outDir: variant ? `./dist-${variant}` : './dist',
+  trailingSlash: 'ignore',
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en', 'pt-br'],
+    routing: {
+      prefixDefaultLocale: false,
+    },
+  },
+});

blog/.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+dist/
+.astro/

blog/README.md

@@ -0,0 +1,45 @@
+# LuminusOS Blog
+
+The blog at [blog.luminusos.org](https://blog.luminusos.org), built with
+[Astro](https://astro.build) content collections.
+
+Posts are written in **English only**. The header has a Translate menu that
+hands the current page to Google Translate's proxy
+(`blog-luminusos-org.translate.goog`) for machine translation into other
+languages, so there is nothing to maintain per language.
+
+## Writing a post
+
+Add a Markdown file to `src/content/posts/`:
+
+```md
+---
+title: 'Post title'
+description: One-sentence summary shown in the list and in meta tags.
+date: 2026-06-10
+tag: Announcement
+---
+
+Content in Markdown…
+```
+
+The file name becomes the URL: `my-post.md` → `/posts/my-post/`.
+
+## Development
+
+```sh
+npm install
+npm run dev      # http://localhost:4321
+npm run build    # static output in dist/
+```
+
+## Deployment
+
+Pushes to `main` deploy to GitHub Pages via `.github/workflows/deploy.yml`.
+One-time setup: enable Pages (Source: GitHub Actions) on this repo and add a
+DNS `CNAME` record `blog.luminusos.org` → `luminusos.github.io`. The `CNAME`
+file ships in `public/`.
+
+## License
+
+MIT

blog/astro.config.mjs

@@ -0,0 +1,7 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+  site: 'https://blog.luminusos.org',
+  trailingSlash: 'ignore',
+});