├── .gitignore ├── .vercelignore ├── README.md ├── cypress.json ├── cypress ├── fixtures │ └── example.json ├── integration │ └── spec.js ├── plugins │ └── index.js └── support │ ├── commands.js │ └── index.js ├── package.json ├── pnpm-lock.yaml ├── postcss.config.js ├── prettier.config.js ├── rollup.config.js ├── src ├── assets │ └── global.pcss ├── client.js ├── components │ ├── Footer.svelte │ └── Nav.svelte ├── routes │ ├── _error.svelte │ ├── _layout.svelte │ ├── about.svelte │ ├── blog │ │ ├── [slug].json.js │ │ ├── [slug].svelte │ │ ├── _posts.js │ │ ├── index.json.js │ │ └── index.svelte │ └── index.svelte ├── server.js ├── service-worker.js └── template.html ├── static ├── favicon.png ├── global.css ├── index.css ├── logo-192.png ├── logo-512.png ├── manifest.json ├── success.jpg └── successkid.jpg ├── svelte.config.js ├── tailwind.config.js └── vercel.json /.gitignore: -------------------------------------------------------------------------------- 1 | .DS_Store 2 | /node_modules/ 3 | /src/node_modules/@sapper/ 4 | yarn-error.log 5 | /cypress/screenshots/ 6 | /__sapper__/ 7 | -------------------------------------------------------------------------------- /.vercelignore: -------------------------------------------------------------------------------- 1 | __sapper__ 2 | node_modules 3 | cypress 4 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # sapper-with-postcss-and-tailwind 2 | 3 | > Example Sapper app with PostCSS and Tailwind CSS :partying_face: 4 | 5 | Want to know all the juicy details? Read the blog post [Solid Sapper setup with PostCSS and Tailwind](https://codechips.me/sapper-with-postcss-and-tailwind/). 6 | 7 | ## Live demo 8 | 9 | https://sapper-with-postcss-and-tailwind.vercel.app 10 | 11 | ## There is more! 12 | 13 | For more interesting stuff find me on [Twitter](https://twitter.com/codechips) or check out my blog at [codechips.me](https://codechips.me). 14 | 15 | ## License 16 | 17 | MIT 18 | -------------------------------------------------------------------------------- /cypress.json: -------------------------------------------------------------------------------- 1 | { 2 | "baseUrl": "http://localhost:3000", 3 | "video": false 4 | } -------------------------------------------------------------------------------- /cypress/fixtures/example.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "Using fixtures to represent data", 3 | "email": "hello@cypress.io", 4 | "body": "Fixtures are a great way to mock data for responses to routes" 5 | } -------------------------------------------------------------------------------- /cypress/integration/spec.js: -------------------------------------------------------------------------------- 1 | describe('Sapper template app', () => { 2 | beforeEach(() => { 3 | cy.visit('/') 4 | }); 5 | 6 | it('has the correct

_error.svelte: -------------------------------------------------------------------------------- 1 | 7 | 8 | 29 | 30 | 31 | {status} 32 | 33 | 34 |

{status}

35 | 36 |

{error.message}

37 | 38 | {#if dev && error.stack} 39 |

{error.stack}

40 | {/if} 41 | -------------------------------------------------------------------------------- /src/routes/_layout.svelte: -------------------------------------------------------------------------------- 1 | 7 | 8 |

9 |

17 | -------------------------------------------------------------------------------- /src/routes/about.svelte: -------------------------------------------------------------------------------- 1 | 2 | About 3 | 4 | 5 |

About this site

6 | 7 |

This is the 'about' page. There's not much here.

-------------------------------------------------------------------------------- /src/routes/blog/[slug].json.js: -------------------------------------------------------------------------------- 1 | import posts from './_posts.js'; 2 | 3 | const lookup = new Map(); 4 | posts.forEach(post => { 5 | lookup.set(post.slug, JSON.stringify(post)); 6 | }); 7 | 8 | export function get(req, res, next) { 9 | // the `slug` parameter is available because 10 | // this file is called [slug].json.js 11 | const { slug } = req.params; 12 | 13 | if (lookup.has(slug)) { 14 | res.writeHead(200, { 15 | 'Content-Type': 'application/json' 16 | }); 17 | 18 | res.end(lookup.get(slug)); 19 | } else { 20 | res.writeHead(404, { 21 | 'Content-Type': 'application/json' 22 | }); 23 | 24 | res.end(JSON.stringify({ 25 | message: `Not found` 26 | })); 27 | } 28 | } 29 | -------------------------------------------------------------------------------- /src/routes/blog/[slug].svelte: -------------------------------------------------------------------------------- 1 | 15 | 16 | 19 | 20 | 21 | {post.title} 22 | 23 | 24 |

25 |

{post.title}

26 | 27 | {@html post.html} 28 |

29 | -------------------------------------------------------------------------------- /src/routes/blog/_posts.js: -------------------------------------------------------------------------------- 1 | // Ordinarily, you'd generate this data from markdown files in your 2 | // repo, or fetch them from a database of some kind. But in order to 3 | // avoid unnecessary dependencies in the starter template, and in the 4 | // service of obviousness, we're just going to leave it here. 5 | 6 | // This file is called `_posts.js` rather than `posts.js`, because 7 | // we don't want to create an `/blog/posts` route — the leading 8 | // underscore tells Sapper not to do that. 9 | 10 | const posts = [ 11 | { 12 | title: 'What is Sapper?', 13 | slug: 'what-is-sapper', 14 | html: ` 15 |

First, you have to know what Svelte is. Svelte is a UI framework with a bold new idea: rather than providing a library that you write code with (like React or Vue, for example), it's a compiler that turns your components into highly optimized vanilla JavaScript. If you haven't already read the introductory blog post, you should!

16 | 17 |

Sapper is a Next.js-style framework (more on that here) built around Svelte. It makes it embarrassingly easy to create extremely high performance web apps. Out of the box, you get:

18 | 19 |

Code-splitting, dynamic imports and hot module replacement, powered by webpack
Server-side rendering (SSR) with client-side hydration
Service worker for offline support, and all the PWA bells and whistles
The nicest development experience you've ever had, or your money back

25 | 26 |

It's implemented as Express middleware. Everything is set up and waiting for you to get started, but you keep complete control over the server, service worker, webpack config and everything else, so it's as flexible as you need it to be.

27 | ` 28 | }, 29 | 30 | { 31 | title: 'How to use Sapper', 32 | slug: 'how-to-use-sapper', 33 | html: ` 34 |

Step one

35 |

Create a new project, using degit:

36 | 37 |

npx degit "sveltejs/sapper-template#rollup" my-app
38 | 			cd my-app
39 | 			npm install # or yarn!
40 | 			npm run dev
41 |

42 | 43 |

Step two

44 |

Go to localhost:3000. Open my-app in your editor. Edit the files in the src/routes directory or add new ones.

45 | 46 |

Step three

47 |

...

48 | 49 |

Step four

50 |

Resist overdone joke formats.

51 | ` 52 | }, 53 | 54 | { 55 | title: 'Why the name?', 56 | slug: 'why-the-name', 57 | html: ` 58 |

In war, the soldiers who build bridges, repair roads, clear minefields and conduct demolitions — all under combat conditions — are known as sappers.

59 | 60 |

For web developers, the stakes are generally lower than those for combat engineers. But we face our own hostile environment: underpowered devices, poor network connections, and the complexity inherent in front-end engineering. Sapper, which is short for Svelte app maker, is your courageous and dutiful ally.

61 | ` 62 | }, 63 | 64 | { 65 | title: 'How is Sapper different from Next.js?', 66 | slug: 'how-is-sapper-different-from-next', 67 | html: ` 68 |

Next.js is a React framework from Vercel, and is the inspiration for Sapper. There are a few notable differences, however:

69 | 70 |

It's powered by Svelte instead of React, so it's faster and your apps are smaller
Instead of route masking, we encode route parameters in filenames. For example, the page you're looking at right now is src/routes/blog/[slug].svelte
As well as pages (Svelte components, which render on server or client), you can create server routes in your routes directory. These are just .js files that export functions corresponding to HTTP methods, and receive Express request and response objects as arguments. This makes it very easy to, for example, add a JSON API such as the one powering this very page
Links are just <a> elements, rather than framework-specific <Link> components. That means, for example, that this link right here, despite being inside a blob of HTML, works with the router as you'd expect.

76 | ` 77 | }, 78 | 79 | { 80 | title: 'How can I get involved?', 81 | slug: 'how-can-i-get-involved', 82 | html: ` 83 |

We're so glad you asked! Come on over to the Svelte and Sapper repos, and join us in the Discord chatroom. Everyone is welcome, especially you!

84 | ` 85 | } 86 | ]; 87 | 88 | posts.forEach(post => { 89 | post.html = post.html.replace(/^\t{3}/gm, ''); 90 | }); 91 | 92 | export default posts; 93 | -------------------------------------------------------------------------------- /src/routes/blog/index.json.js: -------------------------------------------------------------------------------- 1 | import posts from './_posts.js'; 2 | 3 | const contents = JSON.stringify(posts.map(post => { 4 | return { 5 | title: post.title, 6 | slug: post.slug 7 | }; 8 | })); 9 | 10 | export function get(req, res) { 11 | res.writeHead(200, { 12 | 'Content-Type': 'application/json' 13 | }); 14 | 15 | res.end(contents); 16 | } -------------------------------------------------------------------------------- /src/routes/blog/index.svelte: -------------------------------------------------------------------------------- 1 | 8 | 9 | 12 | 13 | 19 | 20 | 21 | Blog 22 | 23 | 24 |