Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/connors/photon
The fastest way to build beautiful Electron apps using simple HTML and CSS
https://github.com/connors/photon
css electron html photon
Last synced: 2 days ago
JSON representation
The fastest way to build beautiful Electron apps using simple HTML and CSS
- Host: GitHub
- URL: https://github.com/connors/photon
- Owner: connors
- License: mit
- Created: 2015-09-28T04:03:26.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2023-12-21T03:09:57.000Z (12 months ago)
- Last Synced: 2024-11-26T05:04:34.663Z (16 days ago)
- Topics: css, electron, html, photon
- Language: CSS
- Homepage: photonkit.com
- Size: 3.01 MB
- Stars: 10,013
- Watchers: 217
- Forks: 579
- Open Issues: 82
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-repos - connors/photon - The fastest way to build beautiful Electron apps using simple HTML and CSS (CSS)
- jimsghstars - connors/photon - The fastest way to build beautiful Electron apps using simple HTML and CSS (CSS)
- starred-awesome - photon - The fastest way to build beautiful Electron apps using simple HTML and CSS (CSS)
README
# [Photon](http://photonkit.com/)
[](https://travis-ci.org/connors/photon)
UI toolkit for building desktop apps with Electron.
## Getting started
* Clone the repo with `git clone https://github.com/connors/photon.git`
* [Read the docs](http://photonkit.com) to learn about the components and how to get your new application started
Take note that our master branch is our active, unstable development branch and that if you're looking to download a stable copy of the repo, check the [tagged downloads](https://github.com/connors/photon/tags).
### What's included
Within the download you'll find the following directories and files, logically grouping common assets. You'll see something like this:
```
photon/
├── css/
│ ├── photon.css
├── fonts/
│ ├── photon-entypo.eot
│ ├── photon-entypo.svg
│ ├── photon-entypo.ttf
│ └── photon-entypo.woff
└── template-app/
├── js/
│ └── menu.js
├── app.js
├── index.html
└── package.json
```
We provide compiled CSS (`photon.*`). We also include the Entypo fonts and a template Electron application for you to quickly get started.
## Documentation
Photon's documentation is built with [Jekyll](http://jekyllrb.com) and publicly hosted on GitHub Pages at . The docs may also be run locally.
### Running documentation locally
1. If necessary, [install Jekyll](http://jekyllrb.com/docs/installation) (requires v2.5.x).
* **Windows users:** Read [this unofficial guide](http://jekyll-windows.juthilo.com/) to get Jekyll up and running without problems.
2. Install the Ruby-based syntax highlighter, [Rouge](https://github.com/jneen/rouge), with `gem install rouge`.
3. From the root `/photon` directory, run `jekyll serve` in the command line.
4. Open in your browser, and boom!
Learn more about using Jekyll by reading its [documentation](http://jekyllrb.com/docs/home/).
## Contributing
Please file a GitHub issue to [report a bug](https://github.com/connors/photon/issues). When reporting a bug, be sure to follow the [contributor guidelines](https://github.com/connors/photon/blob/master/CONTRIBUTING.md).
## Development
1. Install node dependencies: `npm install`.
2. Open the example app: `npm start`.
Modifying source Sass files? Open a second Terminal tab and run `npm run build` to kick off a build of the compiled `photon.css`.
## Versioning
For transparency into our release cycle and in striving to maintain backward compatibility, Photon is maintained under the Semantic Versioning guidelines. Sometimes we screw up, but we'll adhere to these rules whenever possible.
Releases will be numbered with the following format:
`..`
And constructed with the following guidelines:
* Breaking backward compatibility **bumps the major** while resetting minor and patch
* New additions without breaking backward compatibility **bumps the minor** while resetting the patch
* Bug fixes and misc changes **bumps only the patch**
For more information on SemVer, please visit .
## Maintainers
Connor Sears
*
*
## License
Copyright @connors. Released under MIT.