This content originally appeared on DEV Community and was authored by Brittney Postma
If you haven't heard about SvelteKit yet, go checkout the beautiful site over at kit.svelte.dev. SvelteKit is a component framework similar to React and Vue with one key difference, there is no virtual DOM. Svelte is a compiler that builds itself away into a sleek and fast end user experience. If you haven't tried Svelte or SvelteKit before, you can check out my quick intro tutorial where we build a blog in 30 minutes ?
Links:
TLDR: To setup an alias add the following lines to the svelte.config.js and the jsconfig.json files with the alias you want to create.
//svelte.config.js
import path from 'path'
const config = {
kit: {
target: '#svelte',
// add from here, plus the import path from 'path'
vite: {
resolve: {
alias: {
// these are the aliases and paths to them
'@components': path.resolve('./src/lib/components'),
'@lib': path.resolve('./src/lib'),
'@utils': path.resolve('./src/lib/utils')
}
}
}
},
}
export default config
// jsconfig.json
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
// name and path to aliases
"@components": ["src/lib/components"],
"@lib": ["src/lib"],
"@utils": ["src/lib/utils"]
}
},
"include": ["src/**/*.d.ts", "src/**/*.js", "src/**/*.svelte"]
}
Default Starter
To start a new SvelteKit project run npm init svelte@next app-name into the terminal where you want the folder to live. Change directory into your new app, cd app-name and run npm i to install the dependencies. Out of the box SvelteKit provides a $lib alias setup for the src/lib folder and a number of modules are available from $app and $service-worker. Outside of those, it is up to us to set up our own aliases and preferences on how to use them. These all use the $ syntax to use it, however, we are able to change the lib folder to @ or other symbol if preferred.
Change default alias
To update the default $lib alias to @lib, we need to tell vite that we want to use it by updating the svelte.config.js and the jsconfig.json file. Inside the svelte.config.js by default we see this setup.
/** @type {import('@sveltejs/kit').Config} */
const config = {
kit: {
// hydrate the <div id="svelte"> element in src/app.html
target: '#svelte',
},
}
export default config
Inside of the kit property, we need to add a vite config for the aliases we are setting up. I prefer the @ symbol and will show how to setup the @lib, @components, and @utils aliases. We need to import the included path module from node at the top and add the vite property under the kit property. The new svelte.config.js will look like this.
//svelte.config.js
import path from 'path'
const config = {
kit: {
target: '#svelte',
// add from here, plus the import path from 'path'
vite: {
resolve: {
alias: {
// these are the aliases and paths to them
'@components': path.resolve('./src/lib/components'),
'@lib': path.resolve('./src/lib'),
'@utils': path.resolve('./src/lib/utils')
}
}
}
},
}
export default config
Next, we also need to set them up inside the jsconfig.json file. By default that looks like this.
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
// here is the default $lib setup by SvelteKit
"$lib/*": ["src/lib/*"]
}
},
"include": ["src/**/*.d.ts", "src/**/*.js", "src/**/*.svelte"]
}
As you can see, the default $lib is added to this config already. We need to update that and add the paths for our other two aliases. The updated file will look like this.
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@components": ["src/lib/components"],
"@lib": ["src/lib"],
"@utils": ["src/lib/utils"]
}
},
"include": ["src/**/*.d.ts", "src/**/*.js", "src/**/*.svelte"]
}
Under paths we have added the @components, updated the $lib to @lib, and added @utils with the corresponding paths.
Using the aliases
Now we need to use the aliases inside of a file. The skeleton starter doesn't come with any folders outside of the routes folder for the routes of the application. If you chose this option, you can simply add the lib folder inside of the src folder to use the @lib alias. The other paths and aliases we setup are nested inside the lib folder. Add a components folder and utils folder inside of the lib folder. The folder structure should look like this.
src
- lib
- components
- utils
- routes
Now any files created inside of lib, components, or utils can be imported using the alias rather than having to type out the absolute path, like so.
<script>
import FileName from '@lib/FileName.js`
import ComponentName from '@components/ComponentName.svelte'
import UtilName from '@utils/UtilName.js`
</script>
And that's it ? now you can use all of the aliases we created or create more of your own. I'm @brittneypostma on Twitter if you have more questions or just want to chat about Svelte ? Cheers!
This content originally appeared on DEV Community and was authored by Brittney Postma
Brittney Postma | Sciencx (2021-08-05T00:08:14+00:00) Make Pathing Easier with Aliases in SvelteKit. Retrieved from https://www.scien.cx/2021/08/05/make-pathing-easier-with-aliases-in-sveltekit/
Please log in to upload a file.
There are no updates yet.
Click the Upload button above to add an update.