A true WordPress theme with the guts ripped out and replaced with Vue. Looking to create a Vue-powered WordPress plugin? I've got a starter for that too!
Who's this for? When I started diving into using Vue in WordPress I found plenty of great starters for headless WordPress, but I had the added constraint of needing to run the front and backend on the same host, thus this project was created.
Need help? Join the VueWordPress Slack.
npm run watchfor development
npm run buildwhen you're ready to deploy the theme.
(Settings -> Permalinks)to be "Day and name". If you don't want to use this setting you'll need to update the Vue router so it can find your content correctly. Please note that if you want to use a different permalink structure you'll need to update
./src/router/index.jsso it looks for the correct path.
Since by default Tailwind completely resets all styles/spacing, there are a few initial styles I've provided in
src/assets/css/_tailwind.css to make things appear more like you'd expect. Modify to your liking!
All of the code you're going to edit is located in
/src/. From there it's broken into a few logical directories.
/apifor API requests
/assetsfor images mostly
/storevuex store and modules
/vendor3rd party scripts and libraries
All scripts and styles in
/src are compiled down to the
/dist directory, which is what you will deploy. When you're ready to deploy don't deploy the src/ directory.
Not sure where to begin? The Vuejs documentation is actually amazing, but if you're looking for video training I highly recommend the free Learn Vue 2: Step By Step course over at Laracasts. There's also a great playlist by Academind available on YouTube that covers pretty much everything you'd want to know about building a fully-featured Vue app.
I've created a couple of example components in
src/components/widgets to give you an idea of how to work with the Vuex store data.
If you're new to Vue/Vuex I would do the following:
src/app.jsthis is the main JS file for the app and will give you a glimpse into what's going on behind the scenes.
src/App.vuethis is the primary app component, a page wrapper of sorts. It contains the header/footer and the
<router-view>component which is what loads in all of the other screens as you navigate around the app. Note that by default
src/components/Home.vueis loaded into the
src/routes/index.jsand notice how the routes are setup by default. Out of the box there is only one route, the
/or home view. For more information on setting up routing within your app checkout Vue-Router.
src/storeand start to familiarize yourself with what's going on. It's based on the official Vuex example project setup and uses Vuex modules. By default I've included a couple of modules I thought you might need.
The first thing you're probably going to want to do is start editing and components in
2017-10-11 Initial commit