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

Publish new docs website #219

Merged
merged 29 commits into from
Jul 15, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
e001d96
Bootstrapped starlight docs
DaveKeehl Apr 8, 2024
de2aa00
Started working on new website documentation
DaveKeehl Apr 10, 2024
9bcf981
Renamed docs folder
DaveKeehl Apr 10, 2024
57892d6
Added rationale page
DaveKeehl Apr 10, 2024
f453edf
Working on options page
DaveKeehl Apr 11, 2024
d022e81
Added sveltekit page
DaveKeehl Apr 12, 2024
9545451
Updated docs page
DaveKeehl Apr 13, 2024
f919578
Updated docs
DaveKeehl Apr 13, 2024
e7ce580
Options update
DaveKeehl Apr 13, 2024
8924bd1
Updated options presets section
DaveKeehl Apr 13, 2024
1a2dcc8
Updated subheadings
DaveKeehl Apr 13, 2024
da63df2
Converted api table
DaveKeehl Apr 13, 2024
64ab2a4
Converted table
DaveKeehl Apr 13, 2024
72dbd3e
Tweaked page
DaveKeehl Apr 13, 2024
1233818
Converted callbacks table
DaveKeehl Apr 13, 2024
c842b30
Updated options page
DaveKeehl Apr 14, 2024
37eb96c
Docs update
DaveKeehl Apr 14, 2024
ab8e908
Updated cards
DaveKeehl Apr 14, 2024
59f4ab5
Updating docs pages
DaveKeehl Apr 15, 2024
7f2e608
Improved get started
DaveKeehl Apr 15, 2024
5905fe9
Removed suggestions page
DaveKeehl Apr 15, 2024
ef1c66b
Added code snippets
DaveKeehl Apr 15, 2024
a34dfb9
Updated new docs
DaveKeehl Jun 30, 2024
d003f82
Bumped docs version to 1.0.0
DaveKeehl Jun 30, 2024
9a87600
Removed old documentation from README
DaveKeehl Jun 30, 2024
b0ca887
Pointing to new docs
DaveKeehl Jun 30, 2024
1c246b8
Updated changelog
DaveKeehl Jul 1, 2024
a007918
Updated changelog
DaveKeehl Jul 2, 2024
e1a368f
Updated docs readme
DaveKeehl Jul 15, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Svelte Reveal is a library created with the purpose of helping [Svelte](https://

## Documentation

The documentation is available [here](./packages/svelte-reveal/README.md).
You can find full documentation on [svelte-reveal.dev](https://svelte-reveal.dev).

## Monorepo

Expand Down
21 changes: 21 additions & 0 deletions docs/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# build output
dist/
# generated types
.astro/

# dependencies
node_modules/

# logs
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*


# environment variables
.env
.env.production

# macOS-specific files
.DS_Store
12 changes: 12 additions & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# Svelte Reveal - Docs

[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)

This Astro project is the documentation for Svelte Reveal.

## Local development

In order to locally develop this project you need to:

1. Run `npm install` to install the dependencies
2. Run `npm run dev` to start the local dev server at `localhost:4321`
31 changes: 31 additions & 0 deletions docs/astro.config.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';

// https://astro.build/config
export default defineConfig({
integrations: [
starlight({
title: 'Svelte Reveal',
social: {
github: 'https://github.com/davekeehl/svelte-reveal'
},
editLink: {
baseUrl: 'https://github.com/davekeehl/svelte-reveal/edit/main/docs/'
},
sidebar: [
{
label: 'Start Here',
autogenerate: { directory: 'start-here' }
},
{
label: 'Reference',
autogenerate: { directory: 'reference' }
}
],
customCss: [
// Relative path to your custom CSS file
'./src/styles/custom.css'
]
})
]
});
21 changes: 21 additions & 0 deletions docs/package.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
{
"name": "docs",
"type": "module",
"version": "1.0.0",
"scripts": {
"dev": "astro dev",
"start": "astro dev",
"build": "astro check && astro build",
"preview": "astro preview",
"astro": "astro",
"clean": "rimraf .astro .turbo node_modules package-lock.json dist"
},
"dependencies": {
"@astrojs/check": "^0.5.10",
"@astrojs/starlight": "^0.21.4",
"astro": "^4.3.5",
"rimraf": "^5.0.5",
"sharp": "^0.32.5",
"typescript": "^5.4.4"
}
}
1 change: 1 addition & 0 deletions docs/public/favicon.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
77 changes: 77 additions & 0 deletions docs/src/assets/hero_img_dark.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
77 changes: 77 additions & 0 deletions docs/src/assets/hero_img_light.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
90 changes: 90 additions & 0 deletions docs/src/assets/ogImage.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 6 additions & 0 deletions docs/src/content/config.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
import { defineCollection } from 'astro:content';
import { docsSchema } from '@astrojs/starlight/schema';

export const collections = {
docs: defineCollection({ schema: docsSchema() })
};
41 changes: 41 additions & 0 deletions docs/src/content/docs/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
title: Simple scroll based animations for Svelte
description: Svelte Reveal is your go-to library for adding simple scroll based animations to your Svelte apps.
template: splash
hero:
tagline: Svelte Reveal is your go-to library for adding simple scroll based animations to your Svelte apps.
image:
dark: ../../assets/hero_img_dark.svg
light: ../../assets/hero_img_light.svg
actions:
- text: Get started
link: /start-here/getting-started/
icon: right-arrow
variant: primary
- text: View on GitHub
link: https://github.com/davekeehl/svelte-reveal
icon: external
---

import { Card, CardGrid } from '@astrojs/starlight/components';

<CardGrid>
<Card title="Near zero config" icon="rocket">
Get started really fast with just a few lines of code.
</Card>
<Card title="Highly customizable" icon="puzzle">
Creating custom transitions with Svelte Reveal is a <em>breeze</em>.
</Card>
<Card title="100% TypeScript" icon="seti:typescript">
Built from the ground up for maximum type safety.
</Card>
<Card title="Exhaustive documentation" icon="open-book">
We spent a lot of time documenting every bit possible.
</Card>
<Card title="Intersection Observer" icon="seti:svg">
Built-in support for the Intersection Observer API.
</Card>
<Card title="Extensive API" icon="seti:json">
Need full control? We got you covered.
</Card>
</CardGrid>
Loading