37880d297b | ||
---|---|---|
.github | ||
.vscode | ||
src | ||
urara | ||
workflows | ||
.dockerignore | ||
.eslintignore | ||
.eslintrc.cjs | ||
.eslintrc.json | ||
.gitattributes | ||
.gitignore | ||
.npmrc | ||
.nvmrc | ||
.prettierignore | ||
.prettierrc.json | ||
LICENSE | ||
README.md | ||
mdsvex.config.js | ||
netlify.toml | ||
package.json | ||
postcss.config.cjs | ||
svelte.config.js | ||
tailwind.config.ts | ||
tsconfig.json | ||
tsconfig.node.json | ||
urara.ts | ||
vite.config.ts |
README.md
Hello world, this is my personal site
I recently switched to Urara, an incredibly well made template, because although my site was beautiful and worked, it was an immense hassle to get it working and I couldn't fix some issues with mdsvex. I found Urara while looking for code highlighting and it has the same and more features than my completely own work. You should see my previous site at a backup branch. It should be able to be run in dev, but typography from tailwindcss is not working with articles... Featuring a blog, projects, current social accounts, skills and so on and so on, look at Technical Features
Stack info
I focused on researching the best possible modern solutions to frontend and worked on my previous knowledge of svelte.
Javascript, Typescript Framework: Sveltekit CSS: Tailwindcss, postcss MDsveX for markdown text file processing with plugins Dockerfile, node-adapter for custom deploy AWS S3 for static assets AWS lambda for automation
Technical Features
- A possibility of great .md file processing with ability to use svelte components in .md
- Rss feed
- Sitemap, robots, Manifest, Workers
- Some playwright testing
Credits
This project is using Skeleton Labs UI / Component / utils Library for sveltekit. This project used some logic of gitpod.io sveltekit blog with MIT License, however they have shortly pulled their site off of github, their source or license now unreachable. I have learned some svelte tricks used here from Matt Croat alias [https://joyofcode.xyz/]
🚀 Demo / 📝 Documentation / 💬 Discussions
English | 正體中文
🎉 Try it now!
Local
npx degit importantimport/urara my-blog && cd my-blog # create a new project in my-blog
pnpm i # if u don't have pnpm installed, run: npm i -g pnpm
Remote
⚡️ Usage
Developing
Start a development server:
pnpm dev
Building
Create a production version of ur blog:
pnpm build
u can preview the built app with pnpm preview
.
Documentation
For full documentation, visit urara-docs.netlify.app.
Give this project a star
tyvm! ur ⭐ will give me more motivation to improve this project.
✨ Features
- Out of the box Atom feed (WebSub), Sitemap, PWA (Web app manifest & ServiceWorker) support.
- Present beautiful interface designs and animations with daisyUI, of course.
- Good IndieWeb Compatibility - Multi-kind posts with microformats2 markup content, Showcasing Webmentions via webmentions.io API.
- Don't worry about the article and image directories - just put them under a folder and they'll be copied automatically at build time.
- Comment Components: Webmentions, Giscus, Utterances... u can use more than one.
📦️ Pre-packed
TailwindCSS & PostCSS Plugins
- daisyUI - The most popular, free and open-source Tailwind CSS component library.
- Tailwind CSS Typography - Beautiful typographic defaults for HTML you don't control.
- Autoprefixer - Parse CSS and add vendor prefixes to rules by Can I Use.
- CSSNANO - A modular minifier, built on top of the PostCSS ecosystem.
Markdown preprocessor & Syntax highlighter
- MDsveX - A markdown preprocessor for Svelte.
- Shiki Twoslash - A beautiful Syntax Highlighter.
Vite Plugins
🚀 Sites
and more...
are u using Urara? add the urara-blog
topic on ur repo!
👥 Contributing
If u're interested in contributing to Urara, pls read contributing docs before submitting a pull request.
📝 License
This work is free, it comes without any warranty. You can redistribute it and/or modify it under the terms of the Do What The Fuck You Want To Public License, Version 2, as published by Sam Hocevar. See the COPYING file for more details.
special thanks / inspired from:
- @michaeloliverx - Generate Posts List
- icon made by Kpouri