Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add website deployment guide #1999

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open

add website deployment guide #1999

wants to merge 3 commits into from

Conversation

2color
Copy link
Member

@2color 2color commented Feb 21, 2025

What's in this PR

Add deployment to IPFS guide

Why

Helps with the most common use-case of web publishing.

TODO

  • Add link to guide from docs landing page
  • Add link to guide from ipfs landing page
  • Add link to guide from github landing page


**TODO: This whole section should probably move to a separate guide that can be linked to from here**

By default, each deployment will be addressed with a CID. Since CIDs are long and hard to remember, they're not very user friendly, for example, `https://bafybeifhgtpm6kmbyqszbardceszvkv5rsi3dodtuufpcfskzggekcfl2y.ipfs.inbrowser.link/`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[LanguageTool] reported by reviewdog 🐶
This word is normally spelled with a hyphen. (EN_COMPOUNDS_USER_FRIENDLY)
Suggestions: user-friendly
Rule: https://community.languagetool.org/rule/show/EN_COMPOUNDS_USER_FRIENDLY?lang=en-US
Category: MISC

Comment on lines +228 to +230
- Storacha Gateway: `https://<CID>.ipfs.storacha.network`
- IPFS.io Gateway: `https://ipfs.io/ipfs/<CID>`
- Cloudflare Gateway: `https://cloudflare-ipfs.com/ipfs/<CID>`
Copy link
Member

@lidel lidel Mar 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

cloudflare is no more, and since we talk abotu websites here, fine to default to subdomains (need them for relative pathing anyway):

Suggested change
- Storacha Gateway: `https://<CID>.ipfs.storacha.network`
- IPFS.io Gateway: `https://ipfs.io/ipfs/<CID>`
- Cloudflare Gateway: `https://cloudflare-ipfs.com/ipfs/<CID>`
- [Storacha Gateway](https://docs.storacha.network/concepts/ipfs-gateways/): `https://<CID>.ipfs.w3s.link`
- [Public Good Gateway](../concepts/public-utilities.md#public-ipfs-gateways): `https://<CID>.ipfs.dweb.link`


## Step 2: Configure Your Workflow

Create a new file `.github/workflows/deploy.yml` in your repository:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[LanguageTool] reported by reviewdog 🐶
The official name of this software platform is spelled with a capital “H”. (GITHUB[1])
Suggestions: GitHub
URL: https://en.wikipedia.org/wiki/GitHub
Rule: https://community.languagetool.org/rule/show/GITHUB?lang=en-US&subId=1
Category: CASING

run: npm run build

- name: Deploy to IPFS
uses: ipfs/ipfs-deploy-action@v1
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[LanguageTool] reported by reviewdog 🐶
This abbreviation for “identification” is spelled all-uppercase. (ID_CASING[2])
Suggestions: ID
Rule: https://community.languagetool.org/rule/show/ID_CASING?lang=en-US&subId=2
Category: CASING

path-to-deploy: dist # Change this to your build output directory
storacha-key: ${{ secrets.STORACHA_KEY }}
storacha-proof: ${{ secrets.STORACHA_PROOF }}
github-token: ${{ github.token }}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[LanguageTool] reported by reviewdog 🐶
The official name of this software platform is spelled with a capital “H”. (GITHUB[1])
Suggestions: GitHub
URL: https://en.wikipedia.org/wiki/GitHub
Rule: https://community.languagetool.org/rule/show/GITHUB?lang=en-US&subId=1
Category: CASING

path-to-deploy: dist # Change this to your build output directory
storacha-key: ${{ secrets.STORACHA_KEY }}
storacha-proof: ${{ secrets.STORACHA_PROOF }}
github-token: ${{ github.token }}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[LanguageTool] reported by reviewdog 🐶
If a new sentence starts here, add a space and start with an uppercase letter. (LC_AFTER_PERIOD[1])
Suggestions: Token, token
Rule: https://community.languagetool.org/rule/show/LC_AFTER_PERIOD?lang=en-US&subId=1
Category: CASING

Copy link
Contributor

github-actions bot commented Mar 3, 2025

🚀 Build Preview on IPFS ready

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants