Volusion theme for the AngularJS Framework
You can use any front-end framework or libraries you want on the Volusion platform, as long as you interface with the Volusion API. This AngularJS theme project, however, has been created in aim to streamline the design and development of themes available in the Volusion theme store. This project is intended to get you up and running in no time, so you can focus on what matters most.
First, you need a GitHub account. A free account will do you just fine.
Next, unless you're a git wizard (a gizard?), you'll want to also install a git client. There are a number to choose from, but the official GitHub ones are actually pretty nice.
Windows Pro Tip: In the GitHub for Windows client, select Tools >> Options and change your default shell to Git Bash. Select your project, hit the Tools and Options button and then "open a shell here" or just hit the back tick key ``` as a shortcut. You now have an excellent Git shell with your Git credentials already stored.
Another Windows Pro Tip: Add "C:\Users\xxx\AppData\Local\GitHub\PortableGit_xxx\bin" to your PATH user environment variable to gain access to common *nix commands in your Windows Command Prompt without installing msysgit or cygwin.
See also: Set Up Git · GitHub Help
If you scroll all the way to the top of this page, you'll see a Fork button. Click it! After a moment, you will be forwarded to your fork of this project. That's it!
See also: Fork A Repo · GitHub Help
Now, in the right pane, you'll see a "Clone in Desktop" button. Click it! Your git client will be started and the cloning process will start.
See also: Fork a Repo, Step 2: Clone your fork · GitHub Help
As a general practice, you want to stay off the main "master" branch of the repository. This means you'll need to create a new branch for your theme and work on top of that.
Click the branch button at the top where it says "master" and type the name of your theme in the text box. Hit ENTER or click the "+ create branch: xxx" button to create and switch to your new branch.
$ git checkout -b my-theme
Switched to branch 'my-theme'
Volusion AngularJS themes use the instructions and deploy script supplied here. To deploy your own themes, you will need to uncomment the commented-out blocks in the .travis.yml file and provide an encrypted GitHub access token for command-line use. To do this the easy way, you will need Ruby installed.
gem install travis
cd my_theme
travis encrypt GITHUB_TOKEN=super_secret --add
The super_secret
should be replaced with the GitHub access token mentioned above.
More details can be found on the Travic CI docs.
TBD © Volusion, Inc.