Skip to content

Commit 9c44dcc

Browse files
code5717code5717
committed
docs(site): migrate website from Astro to Vite React app
1 parent f4eecdb commit 9c44dcc

61 files changed

Lines changed: 3357 additions & 9563 deletions

Some content is hidden

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

‎site/.gitignore‎

Lines changed: 18 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,25 @@
1-
# build output
2-
dist/
3-
# generated types
4-
.astro/
5-
6-
# dependencies
7-
node_modules/
8-
9-
# logs
1+
# Logs
2+
logs
3+
*.log
104
npm-debug.log*
115
yarn-debug.log*
126
yarn-error.log*
137
pnpm-debug.log*
8+
lerna-debug.log*
149

10+
node_modules
11+
dist
12+
dist-ssr
13+
bun.lock
14+
*.local
1515

16-
# environment variables
17-
.env
18-
.env.production
19-
20-
# macOS-specific files
16+
# Editor directories and files
17+
.vscode/*
18+
!.vscode/extensions.json
19+
.idea
2120
.DS_Store
21+
*.suo
22+
*.ntvs*
23+
*.njsproj
24+
*.sln
25+
*.sw?

‎site/.vscode/extensions.json‎

Lines changed: 0 additions & 4 deletions
This file was deleted.

‎site/.vscode/launch.json‎

Lines changed: 0 additions & 11 deletions
This file was deleted.

‎site/README.md‎

Lines changed: 22 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,47 @@
11
# A7 Documentation Site
22

3-
This site is a custom Astro static site.
3+
React + TypeScript + Vite docs frontend for the A7 compiler repository.
44

5-
It does not use a docs template.
6-
7-
Routes are flat and direct.
8-
9-
## Local development
5+
## Local Development
106

117
```bash
128
cd site
139
npm install
1410
npm run dev
1511
```
1612

13+
The site uses `HashRouter`, so routes resolve as `#/path` locally and on GitHub Pages.
14+
1715
## Build
1816

1917
```bash
2018
cd site
2119
npm run build
20+
npm run preview
2221
```
2322

24-
## Check
23+
## Quality Checks
2524

2625
```bash
2726
cd site
28-
npm run check
27+
npm run lint
2928
```
3029

31-
## Deployment
30+
Repository-level docs style checks:
3231

33-
GitHub Actions deploys `site/dist` to GitHub Pages.
32+
```bash
33+
uv run python scripts/check_docs_style.py
34+
```
3435

35-
Workflow file: `.github/workflows/deploy-docs.yml`
36+
## Styling System
37+
38+
Design tokens and shared interface styles live in:
39+
40+
- `site/src/styles/tokens.css`
41+
- `site/src/index.css`
42+
43+
Primary shared UI primitives live in `site/src/components/`.
44+
45+
## Deployment
3646

37-
Production URL: `https://airbus5717.github.io/a7-py/`
47+
GitHub Pages deploy runs from `.github/workflows/deploy-docs.yml` when docs-related files change on `main`/`master`.

‎site/astro.config.mjs‎

Lines changed: 0 additions & 7 deletions
This file was deleted.

‎site/eslint.config.js‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
import js from '@eslint/js'
2+
import globals from 'globals'
3+
import reactHooks from 'eslint-plugin-react-hooks'
4+
import reactRefresh from 'eslint-plugin-react-refresh'
5+
import tseslint from 'typescript-eslint'
6+
import { defineConfig, globalIgnores } from 'eslint/config'
7+
8+
export default defineConfig([
9+
globalIgnores(['dist']),
10+
{
11+
files: ['**/*.{ts,tsx}'],
12+
extends: [
13+
js.configs.recommended,
14+
tseslint.configs.recommended,
15+
reactHooks.configs.flat.recommended,
16+
reactRefresh.configs.vite,
17+
],
18+
languageOptions: {
19+
ecmaVersion: 2020,
20+
globals: globals.browser,
21+
},
22+
},
23+
])

‎site/index.html‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
<!doctype html>
2+
<html lang="en">
3+
<head>
4+
<meta charset="UTF-8" />
5+
<link rel="icon" type="image/svg+xml" href="/a7-py/favicon.svg" />
6+
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
7+
<title>A7 Programming Language</title>
8+
<meta name="description" content="A7 is a statically-typed, procedural language with array programming capabilities, generics, and manual memory management. Compiles to Zig." />
9+
</head>
10+
<body>
11+
<div id="root"></div>
12+
<script type="module" src="/src/main.tsx"></script>
13+
</body>
14+
</html>

0 commit comments

Comments
 (0)