Skip to content

Issue 93 setup astro#104

Merged
afucher merged 5 commits intodoc-websitefrom
issue-93-setup-astro
Mar 30, 2026
Merged

Issue 93 setup astro#104
afucher merged 5 commits intodoc-websitefrom
issue-93-setup-astro

Conversation

@afucher
Copy link
Copy Markdown
Contributor

@afucher afucher commented Mar 30, 2026

No description provided.

afucher added 5 commits March 30, 2026 10:23
Implements the initial website directory with:
- Astro + Starlight configuration
- TypeScript setup (tsconfig.json)
- Component structure (ChartDemo, SinceBadge)
- Custom landing page (src/pages/index.astro)
- Documentation pages structure (src/content/docs/)
  * Getting Started: introduction, installation, quickstart
  * Guides: radix, transit, animation, custom settings, etc.
  * Framework integrations: React, Vue, Angular
  * API Reference: Chart, Radix, Transit, Settings, Types, etc.
  * Project: changelog, contributing
- Placeholder logo and styles
- .gitignore and environment setup

Acceptance criteria met:
✓ website/ directory created with package.json
✓ astro.config.mjs configured with Starlight
✓ TypeScript setup
✓ src/ directory structure with pages, components, styles, content/docs
✓ public/ directory with placeholder logo
✓ ChartDemo and SinceBadge components ready

Next: npm install and verify build (will be done in Phase 1)
- Fix tsconfig.json: correct Astro tsconfig preset path (configs/ -> tsconfigs/)
- Upgrade to astro@^6.0.0 + @astrojs/starlight@^0.38.0 (Zod v4 compatible)
- Add .npmrc with legacy-peer-deps=true for peer dependency resolution
- Fix src/content.config.ts location and add docsLoader() (Astro 6 requirement)
- Fix astro.config.mjs sidebar slugs (remove 'docs/' prefix)
- Fix social config syntax (array instead of object, Starlight v0.33+ change)
- Rewrite landing page to use StarlightPage component correctly
- Fix internal links to use correct route paths

Build result: 24 pages built, search index generated, sitemap created.
- Add Environment section (nvm use 24, website sub-project)
- Add Adding New Dependencies section with verification workflow
The website/ sub-project has its own node_modules with Astro/Starlight
packages. Without exclusions, ts-loader was crawling into website/node_modules/
and failing with 24 TypeScript errors.

- tsconfig.json: add 'website' to exclude list
- webpack.config.js: add /website/ to ts-loader exclude regex
@afucher afucher merged commit d6692d9 into doc-website Mar 30, 2026
3 checks passed
@afucher afucher deleted the issue-93-setup-astro branch March 30, 2026 14:43
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.

1 participant