Skip to content

izznatsir/solid-site

 
 

Repository files navigation

Solid Docs

Solid Website

This is the source code for the solid website: https://solidjs.com/

Getting started

The website is built with Solid. In order to get going, you should be familiar with the core API of Solid and how it works on the surface.

Prerequisites

Install

  1. Clone the project locally: git clone https://github.com/solidjs/solid-site
  2. Change directory into your local copy: cd solid-site
  3. Install the dependencies: yarn install

Available commands

  • yarn install: Install the dependencies
  • yarn dev: Start the dev server
  • yarn build: Build the project
  • yarn build:sitemap: Generate the sitemap.xml file
  • yarn format: Format the whole project with prettier
  • yarn deploy:dev: Helper method to deploy to dev
  • yarn deploy:prod: Helper method to deploy to prod

PWA Testing

Solid Site supports PWA and worker auto updating powered by Vite PWA Plugin. When testing run yarn https-preview. Running it the first time will ask to install the certificate if not yet done. Then open your Chrome and press F12 > Network Tab > browse to https://localhost. Wait until the network requests with gears at the begining stops downloading the SW precache, then on the same Network Tab just change No throttling option to Offline. All pages should work by pressing F5 (do not do a hard refresh Crtl + F5 as it will force the browser to go to the server and the Chrome Dinosaur will appear).

Additional information

How do the documentation files work?

They're imported from the Solid Docs package. There's a script there that builds the markdown files into consumable JSON files, and the package provides functions to load them.

Credits

Contributions

We are actively accepting contributions to improve the Solid website. We accept PRs that are well-structured, have formatting applied and follow the general structure of the site. If you have any questions, want to report a bug or a general concern, feel free to reach us on GitHub Issues or Discord.

Sponsors

Thank you to our generous and helpful sponsors. If you're interested in sponsoring Solid, reach out to us on Discord.

About

Code that powers the SolidJS.com platform.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 93.7%
  • JavaScript 3.0%
  • CSS 2.5%
  • Other 0.8%