Git Product home page Git Product logo

solid-site's Introduction

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.

Open in StackBlitz

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: pnpm i

Available commands

  • pnpm i: Install the dependencies
  • pnpm dev: Start the dev server
  • pnpm build: Build the project
  • pnpm build:sitemap: Generate the sitemap.xml file
  • pnpm format: Format the whole project with prettier
  • pnpm deploy:dev: Helper method to deploy to dev
  • pnpm 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 pnpm 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 Ctrl + 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.

solid-site's People

Contributors

davedbase avatar amoutonbrady avatar aquaductape avatar ryansolid avatar seneca avatar alidotsal avatar high1 avatar jutanium avatar modderme123 avatar edemaine avatar thetarnav avatar aminya avatar havc-dev avatar pawelblaszczyk5 avatar phiberber avatar renzocabarios avatar mbarzda avatar midouwebdev avatar jay-es avatar dependabot[bot] avatar mosheduminer avatar dev-rb avatar lxsmnsyc avatar lechuckroh avatar ivteplo avatar userquin avatar tjenkinson avatar mundry avatar rnwonder avatar bigmistqke avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.