37 changed files with 337 additions and 249 deletions
@ -0,0 +1,113 @@ |
|||||||
|
/* GitRepublic Theme - Light/Dark Mode with Royal Plum Palette */ |
||||||
|
|
||||||
|
:root { |
||||||
|
/* Light theme colors */ |
||||||
|
--royal-plum: #7B1E6D; |
||||||
|
--snow: #FBF7FA; |
||||||
|
--lavender-blush: #EEE6EC; |
||||||
|
--thistle: #D9C8D4; |
||||||
|
--lilac: #C7A0BB; |
||||||
|
|
||||||
|
/* Light theme semantic colors */ |
||||||
|
--bg-primary: var(--snow); |
||||||
|
--bg-secondary: var(--lavender-blush); |
||||||
|
--bg-tertiary: var(--thistle); |
||||||
|
--text-primary: #1a1a1a; |
||||||
|
--text-secondary: #4a4a4a; |
||||||
|
--text-muted: #6b7280; |
||||||
|
--border-color: var(--thistle); |
||||||
|
--border-light: var(--lavender-blush); |
||||||
|
--accent: var(--royal-plum); |
||||||
|
--accent-hover: #6a1f4d; |
||||||
|
--accent-light: var(--lilac); |
||||||
|
--link-color: var(--royal-plum); |
||||||
|
--link-hover: var(--accent-hover); |
||||||
|
--card-bg: #ffffff; |
||||||
|
--card-border: var(--border-color); |
||||||
|
--button-primary: var(--royal-plum); |
||||||
|
--button-primary-hover: var(--accent-hover); |
||||||
|
--button-secondary: var(--lilac); |
||||||
|
--button-secondary-hover: var(--thistle); |
||||||
|
--input-bg: #ffffff; |
||||||
|
--input-border: var(--border-color); |
||||||
|
--input-focus: var(--royal-plum); |
||||||
|
--error-bg: #fee2e2; |
||||||
|
--error-text: #991b1b; |
||||||
|
--success-bg: #d1fae5; |
||||||
|
--success-text: #065f46; |
||||||
|
--warning-bg: #fef3c7; |
||||||
|
--warning-text: #92400e; |
||||||
|
} |
||||||
|
|
||||||
|
[data-theme="dark"] { |
||||||
|
/* Dark theme colors - darker versions of the palette */ |
||||||
|
--royal-plum: #9a2a7f; |
||||||
|
--snow: #1a1418; |
||||||
|
--lavender-blush: #2a1f26; |
||||||
|
--thistle: #3d2f38; |
||||||
|
--lilac: #5a4452; |
||||||
|
|
||||||
|
/* Dark theme semantic colors */ |
||||||
|
--bg-primary: var(--snow); |
||||||
|
--bg-secondary: var(--lavender-blush); |
||||||
|
--bg-tertiary: var(--thistle); |
||||||
|
--text-primary: #f5f5f5; |
||||||
|
--text-secondary: #d1d1d1; |
||||||
|
--text-muted: #a0a0a0; |
||||||
|
--border-color: var(--thistle); |
||||||
|
--border-light: var(--lavender-blush); |
||||||
|
--accent: var(--royal-plum); |
||||||
|
--accent-hover: #b84a8a; |
||||||
|
--accent-light: var(--lilac); |
||||||
|
--link-color: var(--royal-plum); |
||||||
|
--link-hover: var(--accent-hover); |
||||||
|
--card-bg: var(--lavender-blush); |
||||||
|
--card-border: var(--border-color); |
||||||
|
--button-primary: var(--royal-plum); |
||||||
|
--button-primary-hover: var(--accent-hover); |
||||||
|
--button-secondary: var(--lilac); |
||||||
|
--button-secondary-hover: var(--thistle); |
||||||
|
--input-bg: var(--lavender-blush); |
||||||
|
--input-border: var(--border-color); |
||||||
|
--input-focus: var(--royal-plum); |
||||||
|
--error-bg: #4a1f1f; |
||||||
|
--error-text: #ff6b6b; |
||||||
|
--success-bg: #1a3a2a; |
||||||
|
--success-text: #4ade80; |
||||||
|
--warning-bg: #4a3a1f; |
||||||
|
--warning-text: #fbbf24; |
||||||
|
} |
||||||
|
|
||||||
|
/* Base styles */ |
||||||
|
* { |
||||||
|
box-sizing: border-box; |
||||||
|
} |
||||||
|
|
||||||
|
body { |
||||||
|
margin: 0; |
||||||
|
padding: 0; |
||||||
|
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', |
||||||
|
'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue', |
||||||
|
sans-serif; |
||||||
|
-webkit-font-smoothing: antialiased; |
||||||
|
-moz-osx-font-smoothing: grayscale; |
||||||
|
background-color: var(--bg-primary); |
||||||
|
color: var(--text-primary); |
||||||
|
transition: background-color 0.3s ease, color 0.3s ease; |
||||||
|
} |
||||||
|
|
||||||
|
/* Theme toggle utility */ |
||||||
|
.theme-toggle { |
||||||
|
cursor: pointer; |
||||||
|
padding: 0.5rem; |
||||||
|
border: 1px solid var(--border-color); |
||||||
|
border-radius: 0.375rem; |
||||||
|
background: var(--card-bg); |
||||||
|
color: var(--text-primary); |
||||||
|
transition: all 0.2s ease; |
||||||
|
} |
||||||
|
|
||||||
|
.theme-toggle:hover { |
||||||
|
background: var(--bg-secondary); |
||||||
|
border-color: var(--accent); |
||||||
|
} |
||||||
@ -0,0 +1,48 @@ |
|||||||
|
<script lang="ts"> |
||||||
|
import '../app.css'; |
||||||
|
import { onMount } from 'svelte'; |
||||||
|
|
||||||
|
// Theme management |
||||||
|
let theme: 'light' | 'dark' = 'light'; |
||||||
|
|
||||||
|
onMount(() => { |
||||||
|
// Check for saved theme preference or default to light |
||||||
|
const savedTheme = localStorage.getItem('theme') as 'light' | 'dark' | null; |
||||||
|
if (savedTheme === 'light' || savedTheme === 'dark') { |
||||||
|
theme = savedTheme; |
||||||
|
} else { |
||||||
|
// Check system preference |
||||||
|
const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches; |
||||||
|
theme = prefersDark ? 'dark' : 'light'; |
||||||
|
} |
||||||
|
applyTheme(); |
||||||
|
}); |
||||||
|
|
||||||
|
function applyTheme() { |
||||||
|
if (theme === 'dark') { |
||||||
|
document.documentElement.setAttribute('data-theme', 'dark'); |
||||||
|
} else { |
||||||
|
document.documentElement.removeAttribute('data-theme'); |
||||||
|
} |
||||||
|
localStorage.setItem('theme', theme); |
||||||
|
} |
||||||
|
|
||||||
|
function toggleTheme() { |
||||||
|
theme = theme === 'light' ? 'dark' : 'light'; |
||||||
|
applyTheme(); |
||||||
|
} |
||||||
|
|
||||||
|
// Watch for system theme changes |
||||||
|
onMount(() => { |
||||||
|
if (typeof window !== 'undefined') { |
||||||
|
window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', (e) => { |
||||||
|
if (!localStorage.getItem('theme')) { |
||||||
|
theme = e.matches ? 'dark' : 'light'; |
||||||
|
applyTheme(); |
||||||
|
} |
||||||
|
}); |
||||||
|
} |
||||||
|
}); |
||||||
|
</script> |
||||||
|
|
||||||
|
<slot /> |
||||||
@ -0,0 +1,19 @@ |
|||||||
|
/** |
||||||
|
* Page metadata and OpenGraph tags for homepage |
||||||
|
*/ |
||||||
|
|
||||||
|
import type { PageLoad } from './$types'; |
||||||
|
|
||||||
|
export const load: PageLoad = async ({ url }) => { |
||||||
|
const gitDomain = url.host || 'localhost:6543'; |
||||||
|
const protocol = url.protocol === 'https:' ? 'https' : 'http'; |
||||||
|
const baseUrl = `${protocol}://${gitDomain}`; |
||||||
|
|
||||||
|
return { |
||||||
|
title: 'GitRepublic - Decentralized Git Hosting on Nostr', |
||||||
|
description: 'A decentralized git hosting platform built on Nostr. Host your repositories, collaborate with others, and maintain full control of your code.', |
||||||
|
image: `${baseUrl}/logo.png`, |
||||||
|
url: baseUrl, |
||||||
|
ogType: 'website' |
||||||
|
}; |
||||||
|
}; |
||||||
|
After Width: | Height: | Size: 514 KiB |
@ -1,248 +0,0 @@ |
|||||||
NIP-34 |
|
||||||
====== |
|
||||||
|
|
||||||
`git` stuff |
|
||||||
----------- |
|
||||||
|
|
||||||
`draft` `optional` |
|
||||||
|
|
||||||
This NIP defines all the ways code collaboration using and adjacent to [`git`](https://git-scm.com/) can be done using Nostr. |
|
||||||
|
|
||||||
## Repository announcements |
|
||||||
|
|
||||||
Git repositories are hosted in Git-enabled servers, but their existence can be announced using Nostr events. By doing so the author asserts themselves as a maintainer and expresses a willingness to receive patches, bug reports and comments in general, unless `t` tag `personal-fork` is included. |
|
||||||
|
|
||||||
```jsonc |
|
||||||
{ |
|
||||||
"kind": 30617, |
|
||||||
"content": "", |
|
||||||
"tags": [ |
|
||||||
["d", "<repo-id>"], // usually kebab-case short name |
|
||||||
["name", "<human-readable project name>"], |
|
||||||
["description", "brief human-readable project description>"], |
|
||||||
["web", "<url for browsing>", ...], // a webpage url, if the git server being used provides such a thing |
|
||||||
["clone", "<url for git-cloning>", ...], // a url to be given to `git clone` so anyone can clone it |
|
||||||
["relays", "<relay-url>", ...], // relays that this repository will monitor for patches and issues |
|
||||||
["r", "<earliest-unique-commit-id>", "euc"], |
|
||||||
["maintainers", "<other-recognized-maintainer>", ...], |
|
||||||
["t","personal-fork"], // optionally indicate author isn't a maintainer |
|
||||||
["t", "<arbitrary string>"], // hashtags labelling the repository |
|
||||||
] |
|
||||||
} |
|
||||||
``` |
|
||||||
|
|
||||||
The tags `web`, `clone`, `relays`, `maintainers` can have multiple values. |
|
||||||
|
|
||||||
The `r` tag annotated with the `"euc"` marker should be the commit ID of the earliest unique commit of this repo, made to identify it among forks and group it with other repositories hosted elsewhere that may represent essentially the same project. In most cases it will be the root commit of a repository. In case of a permanent fork between two projects, then the first commit after the fork should be used. |
|
||||||
|
|
||||||
Except `d`, all tags are optional. |
|
||||||
|
|
||||||
## Repository state announcements |
|
||||||
|
|
||||||
An optional source of truth for the state of branches and tags in a repository. |
|
||||||
|
|
||||||
```jsonc |
|
||||||
{ |
|
||||||
"kind": 30618, |
|
||||||
"content": "", |
|
||||||
"tags": [ |
|
||||||
["d", "<repo-id>"], // matches the identifier in the corresponding repository announcement |
|
||||||
["refs/<heads|tags>/<branch-or-tag-name>","<commit-id>"] |
|
||||||
["HEAD", "ref: refs/heads/<branch-name>"] |
|
||||||
] |
|
||||||
} |
|
||||||
``` |
|
||||||
|
|
||||||
The `refs` tag may appear multiple times, or none. |
|
||||||
|
|
||||||
If no `refs` tags are present, the author is no longer tracking repository state using this event. This approach enables the author to restart tracking state at a later time unlike [NIP-09](09.md) deletion requests. |
|
||||||
|
|
||||||
The `refs` tag can be optionally extended to enable clients to identify how many commits ahead a ref is: |
|
||||||
|
|
||||||
```jsonc |
|
||||||
{ |
|
||||||
"tags": [ |
|
||||||
["refs/<heads|tags>/<branch-or-tag-name>", "<commit-id>", "<shorthand-parent-commit-id>", "<shorthand-grandparent>", ...], |
|
||||||
] |
|
||||||
} |
|
||||||
``` |
|
||||||
|
|
||||||
## Patches and Pull Requests (PRs) |
|
||||||
|
|
||||||
Patches and PRs can be sent by anyone to any repository. Patches and PRs to a specific repository SHOULD be sent to the relays specified in that repository's announcement event's `"relays"` tag. Patch and PR events SHOULD include an `a` tag pointing to that repository's announcement address. |
|
||||||
|
|
||||||
Patches SHOULD be used if each event is under 60kb, otherwise PRs SHOULD be used. |
|
||||||
|
|
||||||
### Patches |
|
||||||
|
|
||||||
Patches in a patch set SHOULD include a [NIP-10](10.md) `e` `reply` tag pointing to the previous patch. |
|
||||||
|
|
||||||
The first patch revision in a patch revision SHOULD include a [NIP-10](10.md) `e` `reply` to the original root patch. |
|
||||||
|
|
||||||
```jsonc |
|
||||||
{ |
|
||||||
"kind": 1617, |
|
||||||
"content": "<patch>", // contents of <git format-patch> |
|
||||||
"tags": [ |
|
||||||
["a", "30617:<base-repo-owner-pubkey>:<base-repo-id>"], |
|
||||||
["r", "<earliest-unique-commit-id-of-repo>"] // so clients can subscribe to all patches sent to a local git repo |
|
||||||
["p", "<repository-owner>"], |
|
||||||
["p", "<other-user>"], // optionally send the patch to another user to bring it to their attention |
|
||||||
|
|
||||||
["t", "root"], // omitted for additional patches in a series |
|
||||||
// for the first patch in a revision |
|
||||||
["t", "root-revision"], |
|
||||||
|
|
||||||
// optional tags for when it is desirable that the merged patch has a stable commit id |
|
||||||
// these fields are necessary for ensuring that the commit resulting from applying a patch |
|
||||||
// has the same id as it had in the proposer's machine -- all these tags can be omitted |
|
||||||
// if the maintainer doesn't care about these things |
|
||||||
["commit", "<current-commit-id>"], |
|
||||||
["r", "<current-commit-id>"] // so clients can find existing patches for a specific commit |
|
||||||
["parent-commit", "<parent-commit-id>"], |
|
||||||
["commit-pgp-sig", "-----BEGIN PGP SIGNATURE-----..."], // empty string for unsigned commit |
|
||||||
["committer", "<name>", "<email>", "<timestamp>", "<timezone offset in minutes>"], |
|
||||||
] |
|
||||||
} |
|
||||||
``` |
|
||||||
|
|
||||||
The first patch in a series MAY be a cover letter in the format produced by `git format-patch`. |
|
||||||
|
|
||||||
### Pull Requests |
|
||||||
|
|
||||||
The PR or PR update tip SHOULD be successfully pushed to `refs/nostr/<[PR|PR-Update]-event-id>` in all repositories listed in its `clone` tag before the event is signed. |
|
||||||
|
|
||||||
An attempt SHOULD be made to push this ref to all repositories listed in the repository's announcement event's `"clone"` tag, for which their is reason to believe the user might have write access. This includes each [grasp server](https://njump.me/naddr1qvzqqqrhnypzpgqgmmc409hm4xsdd74sf68a2uyf9pwel4g9mfdg8l5244t6x4jdqy28wumn8ghj7un9d3shjtnwva5hgtnyv4mqqpt8wfshxuqlnvh8x) which can be identified using this method: `clone` tag includes `[http|https]://<grasp-path>/<valid-npub>/<string>.git` and `relays` tag includes `[ws/wss]://<grasp-path>`. |
|
||||||
|
|
||||||
Clients MAY fallback to creating a 'personal-fork' `repository announcement` listing other grasp servers, e.g. from the `User grasp list`, for the purpose of serving the specified commit(s). |
|
||||||
|
|
||||||
```jsonc |
|
||||||
{ |
|
||||||
"kind": 1618, |
|
||||||
"content": "<markdown text>", |
|
||||||
"tags": [ |
|
||||||
["a", "30617:<base-repo-owner-pubkey>:<base-repo-id>"], |
|
||||||
["r", "<earliest-unique-commit-id-of-repo>"] // so clients can subscribe to all PRs sent to a local git repo |
|
||||||
["p", "<repository-owner>"], |
|
||||||
["p", "<other-user>"], // optionally send the PR to another user to bring it to their attention |
|
||||||
|
|
||||||
["subject", "<PR-subject>"], |
|
||||||
["t", "<PR-label>"], // optional |
|
||||||
["t", "<another-PR-label>"], // optional |
|
||||||
|
|
||||||
["c", "<current-commit-id>"], // tip of the PR branch |
|
||||||
["clone", "<clone-url>", ...], // at least one git clone url where commit can be downloaded |
|
||||||
["branch-name", "<branch-name>"], // optional recommended branch name |
|
||||||
|
|
||||||
["e", "<root-patch-event-id>"], // optionally indicate PR is a revision of an existing patch, which should be closed |
|
||||||
["merge-base", "<commit-id>"], // optional: the most recent common ancestor with the target branch |
|
||||||
] |
|
||||||
} |
|
||||||
``` |
|
||||||
|
|
||||||
### Pull Request Updates |
|
||||||
|
|
||||||
A PR Update changes the tip of a referenced PR event. |
|
||||||
|
|
||||||
```jsonc |
|
||||||
{ |
|
||||||
"kind": 1619, |
|
||||||
"content": "", |
|
||||||
"tags": [ |
|
||||||
["a", "30617:<base-repo-owner-pubkey>:<base-repo-id>"], |
|
||||||
["r", "<earliest-unique-commit-id-of-repo>"] // so clients can subscribe to all PRs sent to a local git repo |
|
||||||
["p", "<repository-owner>"], |
|
||||||
["p", "<other-user>"], // optionally send the PR to another user to bring it to their attention |
|
||||||
|
|
||||||
// NIP-22 tags |
|
||||||
["E", "<pull-request-event-id>"], |
|
||||||
["P", "<pull-request-author>"], |
|
||||||
|
|
||||||
["c", "<current-commit-id>"], // updated tip of PR |
|
||||||
["clone", "<clone-url>", ...], // at least one git clone url where commit can be downloaded |
|
||||||
["merge-base", "<commit-id>"], // optional: the most recent common ancestor with the target branch |
|
||||||
] |
|
||||||
} |
|
||||||
``` |
|
||||||
|
|
||||||
## Issues |
|
||||||
|
|
||||||
Issues are Markdown text that is just human-readable conversational threads related to the repository: bug reports, feature requests, questions or comments of any kind. Like patches, these SHOULD be sent to the relays specified in that repository's announcement event's `"relays"` tag. |
|
||||||
|
|
||||||
Issues may have a `subject` tag, which clients can utilize to display a header. Additionally, one or more `t` tags may be included to provide labels for the issue. |
|
||||||
|
|
||||||
```json |
|
||||||
{ |
|
||||||
"kind": 1621, |
|
||||||
"content": "<markdown text>", |
|
||||||
"tags": [ |
|
||||||
["a", "30617:<base-repo-owner-pubkey>:<base-repo-id>"], |
|
||||||
["p", "<repository-owner>"] |
|
||||||
["subject", "<issue-subject>"] |
|
||||||
["t", "<issue-label>"] |
|
||||||
["t", "<another-issue-label>"] |
|
||||||
] |
|
||||||
} |
|
||||||
``` |
|
||||||
|
|
||||||
## Replies |
|
||||||
|
|
||||||
Replies to either a `kind:1621` (_issue_), `kind:1617` (_patch_) or `kind:1618` (_pull request_) event should follow [NIP-22 comment](22.md). |
|
||||||
|
|
||||||
## Status |
|
||||||
|
|
||||||
Root Patches, PRs and Issues have a Status that defaults to 'Open' and can be set by issuing Status events. |
|
||||||
|
|
||||||
```jsonc |
|
||||||
{ |
|
||||||
"kind": 1630, // Open |
|
||||||
"kind": 1631, // Applied / Merged for Patches; Resolved for Issues |
|
||||||
"kind": 1632, // Closed |
|
||||||
"kind": 1633, // Draft |
|
||||||
"content": "<markdown text>", |
|
||||||
"tags": [ |
|
||||||
["e", "<issue-or-PR-or-original-root-patch-id-hex>", "", "root"], |
|
||||||
["e", "<accepted-revision-root-id-hex>", "", "reply"], // for when revisions applied |
|
||||||
["p", "<repository-owner>"], |
|
||||||
["p", "<root-event-author>"], |
|
||||||
["p", "<revision-author>"], |
|
||||||
|
|
||||||
// optional for improved subscription filter efficiency |
|
||||||
["a", "30617:<base-repo-owner-pubkey>:<base-repo-id>", "<relay-url>"], |
|
||||||
["r", "<earliest-unique-commit-id-of-repo>"] |
|
||||||
|
|
||||||
// optional for `1631` status |
|
||||||
["q", "<applied-or-merged-patch-event-id>", "<relay-url>", "<pubkey>"], // for each |
|
||||||
// when merged |
|
||||||
["merge-commit", "<merge-commit-id>"] |
|
||||||
["r", "<merge-commit-id>"] |
|
||||||
// when applied |
|
||||||
["applied-as-commits", "<commit-id-in-master-branch>", ...] |
|
||||||
["r", "<applied-commit-id>"] // for each |
|
||||||
] |
|
||||||
} |
|
||||||
``` |
|
||||||
|
|
||||||
The most recent Status event (by `created_at` date) from either the issue/patch author or a maintainer is considered valid. |
|
||||||
|
|
||||||
The Status of a patch-revision is to either that of the root-patch, or `1632` (_Closed_) if the root-patch's Status is `1631` (_Applied/Merged_) and the patch-revision isn't tagged in the `1631` (_Applied/Merged_) event. |
|
||||||
|
|
||||||
## User grasp list |
|
||||||
|
|
||||||
List of [grasp servers](https://njump.me/naddr1qvzqqqrhnypzpgqgmmc409hm4xsdd74sf68a2uyf9pwel4g9mfdg8l5244t6x4jdqy28wumn8ghj7un9d3shjtnwva5hgtnyv4mqqpt8wfshxuqlnvh8x) the user generally wishes to use for NIP-34 related activity. It is similar in function to the NIP-65 relay list and NIP-B7 blossom list. |
|
||||||
|
|
||||||
The event SHOULD include a list of `g` tags with grasp service websocket URLs in order of preference. |
|
||||||
|
|
||||||
```jsonc |
|
||||||
{ |
|
||||||
"kind": 10317, |
|
||||||
"content": "", |
|
||||||
"tags": [ |
|
||||||
["g", "<grasp-service-websocket-url>"], // zero or more grasp sever urls |
|
||||||
] |
|
||||||
} |
|
||||||
``` |
|
||||||
|
|
||||||
## Possible things to be added later |
|
||||||
|
|
||||||
- inline file comments kind (we probably need one for patches and a different one for merged files) |
|
||||||
|
After Width: | Height: | Size: 40 KiB |
|
After Width: | Height: | Size: 3.6 KiB |
|
After Width: | Height: | Size: 236 KiB |
|
After Width: | Height: | Size: 261 KiB |
Loading…
Reference in new issue