Initial setup

.env.example

@@ -0,0 +1,12 @@
+# GitHub Personal Access Token - DO NOT USE IN CLIENT-SIDE CODE
+# 
+# SECURITY WARNING: 
+# Do not add GitHub tokens to this project's configuration.
+# Tokens added to Docusaurus config will be exposed in the browser bundle.
+# 
+# For dynamic GitHub data:
+# - Use the hardcoded data in src/services/github.ts (current approach)
+# - Or implement a backend API/serverless function to fetch data securely
+#
+# This file is kept for documentation purposes only.
+# GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx # DO NOT USE

.github/CONTRIBUTING.md

@@ -0,0 +1,75 @@
+# Contributing to House of Stake
+
+Thanks for helping improve House of Stake! Most content updates do not require a local setup — you can edit files on GitHub and open a pull request (PR). A preview build will be posted on your PR after CI finishes.
+
+## Quick start (no local setup)
+
+1) Find the file
+- On the live site, click the "Edit this page" button in the header to jump to the exact file in GitHub.
+- Or browse files directly in the repository.
+
+2) Edit
+- Click the pencil icon to edit in your browser.
+- For new content:
+  - Docs: Add a Markdown file in the correct folder under `docs/`.
+  - Blog: Add a file in `blog/` named `YYYY-MM-DD-your-slug.md`.
+
+3) Open a pull request
+- Add a short description of what changed and click "Propose changes".
+- CI builds a preview and comments the link on your PR (previews from forks may need maintainer approval).
+
+4) Review and merge
+- Maintainers review, suggest fixes if needed, and merge when ready.
+
+## Where things live
+
+- Homepage content: `src/content/homepage.md`
+  - One YAML frontmatter document controls homepage sections; toggle with `visible: true|false`.
+  - Validated at build time by `src/shared/homepageContentSchema.ts` via the custom plugin in `plugins/homepage-content/`.
+
+- Docs: `docs/`
+  - One topic per Markdown file (`.md`). Use a top-level `# Title` and short sections.
+  - Sidebar items are configured in `sidebars.ts` (add your new doc to the appropriate category `items`).
+  - Images: keep near the doc in `docs/<section>/assets/`, or use `static/img/` and link as `/img/<file>`.
+
+- Blog: `blog/`
+  - File name: `YYYY-MM-DD-your-slug.md`
+  - Frontmatter example:
+    ```yaml
+    ---
+    title: Your Post Title
+    description: One-line summary
+    authors: [houseofstake]
+    tags: [update]
+    ---
+    ```
+  - Authors live in `blog/authors.yml`.
+
+- Legal: `legal/*.mdx`
+  - MDX content rendered by wrappers in `src/pages/*.tsx`.
+  - Optional frontmatter: `title`, `lastUpdated`.
+
+## Content tips
+- Prefer clear headings, short paragraphs, and bullet points.
+- Link to deeper references rather than duplicating large sections.
+- Clearly label examples.
+
+## Local development (optional)
+- Node.js 18+
+- Install: `npm ci` (or `yarn install`)
+- Dev server: `npm run start`
+- Typecheck: `npm run typecheck`
+- Build: `npm run build`
+- Serve build: `npm run serve`
+
+Notes
+- Edit links are mapped in `src/components/homepage/Header.tsx` (plus `editUrl` in `docusaurus.config.ts`). Keep these in sync if branch/org changes.
+
+## CI and previews
+- PRs are built by GitHub Actions; a preview URL is commented on the PR.
+- Production deploy runs on `main` and publishes to `gh-pages`. A `CNAME` on `gh-pages` is respected if present.
+
+## Questions or ideas?
+- Open an issue: https://github.com/houseofstake/houseofstake.org/issues/new
+
+Thank you for contributing!

.github/SUPPORT.md

@@ -0,0 +1,18 @@
+# Support and Feedback
+
+We value your feedback. Please use the options below depending on your need.
+
+## Questions, ideas, and content requests
+- Open a GitHub issue: https://github.com/houseofstake/houseofstake.org/issues/new
+  - Include the page URL or file path, expected vs actual behavior, and a screenshot/snippet if helpful.
+
+## Propose edits directly
+- Click “Edit this page” on the site header to open the file on GitHub, then submit a PR with your changes.
+
+## Community channels
+- Telegram: https://t.me/NEAR_HouseOfStake
+- X (Twitter): https://x.com/NEARGovernance
+- NEAR Forum (House of Stake): https://gov.near.org/c/house-of-stake/158
+- Governance app: https://gov.houseofstake.org
+
+Thank you for helping improve House of Stake.

.github/workflows/security-review.yml

@@ -13,7 +13,7 @@ on:
         required: false
         type: string
         default: ''
-  
+
   # Also trigger on pull requests
   pull_request:
     types: [opened, synchronize, reopened]
@@ -27,7 +27,7 @@ jobs:
         with:
           ref: ${{ github.event.inputs.branch || github.event.pull_request.head.sha || github.sha }}
           fetch-depth: 2
-      
+
       - name: Run Claude Code Security Review
         uses: anthropics/claude-code-security-review@main
         with:
@@ -45,4 +45,4 @@ jobs:
             .github
             .git
           claudecode-timeout: 20
-          run-every-commit: ${{ github.event_name == 'pull_request' }}
+          run-every-commit: ${{ github.event_name == 'pull_request' }}

.github/workflows/security.yml

@@ -0,0 +1,22 @@
+name: Security Review
+
+permissions:
+  pull-requests: write
+  contents: read
+
+on:
+  pull_request:
+
+jobs:
+  security:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.sha }}
+          fetch-depth: 2
+
+      - uses: anthropics/claude-code-security-review@main
+        with:
+          comment-pr: true
+          claude-api-key: ${{ secrets.CLAUDE_API_KEY }}

.gitignore

@@ -10,6 +10,7 @@
 
 # Misc
 .DS_Store
+.env
 .env.local
 .env.development.local
 .env.test.local

.prettierignore

@@ -0,0 +1,22 @@
+# Dependencies
+node_modules/
+package-lock.json
+
+# Production
+build/
+.docusaurus/
+
+# Generated files
+.cache-loader/
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

.prettierrc

@@ -0,0 +1,11 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

README.md

@@ -1,41 +1,14 @@
-# Website
+## House of Stake Website
 
-This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+This repo powers the House of Stake website (Docusaurus). Most content is Markdown.
 
-## Installation
+- [Contributing guide](.github/CONTRIBUTING.md)
+- [Support & feedback](.github/SUPPORT.md)
+- [Open an issue](https://github.com/houseofstake/houseofstake.org/issues/new)
 
-```bash
-yarn
-```
+Local development (quick reference)
+- Install: `npm ci`
+- Dev server: `npm run start`
+- Build: `npm run build`
 
-## Local Development
-
-```bash
-yarn start
-```
-
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
-
-## Build
-
-```bash
-yarn build
-```
-
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
-
-## Deployment
-
-Using SSH:
-
-```bash
-USE_SSH=true yarn deploy
-```
-
-Not using SSH:
-
-```bash
-GIT_USER=<Your GitHub username> yarn deploy
-```
-
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
+License: see `LICENSE`.