-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Initial commit * Remove package-lock.json for now
- Loading branch information
0 parents
commit 370e90d
Showing
24 changed files
with
1,009 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,15 @@ | ||
# http://editorconfig.org | ||
|
||
root = true | ||
|
||
[*] | ||
charset = utf-8 | ||
indent_style = space | ||
indent_size = 2 | ||
end_of_line = lf | ||
insert_final_newline = true | ||
trim_trailing_whitespace = true | ||
|
||
[*.md] | ||
insert_final_newline = false | ||
trim_trailing_whitespace = false |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,86 @@ | ||
# Contributing | ||
|
||
Thanks for your interest in contributing to the Stencil Component Starter! :tada: | ||
|
||
|
||
## Contributing Etiquette | ||
|
||
Please see our [Contributor Code of Conduct](https://github.com/ionic-team/stencil/blob/master/CODE_OF_CONDUCT.md) for information on our rules of conduct. | ||
|
||
|
||
## Creating an Issue | ||
|
||
* If you have a question about using Stencil, please ask in the [Stencil Worldwide Slack](https://join.slack.com/t/stencil-worldwide/shared_invite/enQtMjQ2MzkyMTY0MTk0LTQ4ODgzYjFjNjdkNDY3YWVhMmNlMTljMWQxNTM3Yjg0ZTIyZTM1MmU2YWE5YzNjNzE1MmQ3ZTk2NjQ1YzM5ZDM group. | ||
|
||
* It is required that you clearly describe the steps necessary to reproduce the issue you are running into. Although we would love to help our users as much as possible, diagnosing issues without clear reproduction steps is extremely time-consuming and simply not sustainable. | ||
|
||
* The issue list of this repository is exclusively for bug reports and feature requests. Non-conforming issues will be closed immediately. | ||
|
||
* Issues with no clear steps to reproduce will not be triaged. If an issue is labeled with "needs reply" and receives no further replies from the author of the issue for more than 5 days, it will be closed. | ||
|
||
* If you think you have found a bug, or have a new feature idea, please start by making sure it hasn't already been [reported](https://github.com/ionic-team/stencil/issues?utf8=%E2%9C%93&q=is%3Aissue). You can search through existing issues to see if there is a similar one reported. Include closed issues as it may have been closed with a solution. | ||
|
||
* Next, [create a new issue](https://github.com/ionic-team/stencil-component-starter/issues/new) that thoroughly explains the problem. Please fill out the populated issue form before submitting the issue. | ||
|
||
|
||
## Creating a Pull Request | ||
|
||
* We appreciate you taking the time to contribute! Before submitting a pull request, we ask that you please [create an issue](#creating-an-issue) that explains the bug or feature request and let us know that you plan on creating a pull request for it. If an issue already exists, please comment on that issue letting us know you would like to submit a pull request for it. This helps us to keep track of the pull request and make sure there isn't duplicated effort. | ||
|
||
* Looking for an issue to fix? Make sure to look through our issues with the [help wanted](https://github.com/ionic-team/stencil-component-starter/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) label! | ||
|
||
### Setup | ||
|
||
1. Fork the repo. | ||
2. Clone your fork. | ||
3. Make a branch for your change. | ||
4. Run `npm install` (make sure you have [node](https://nodejs.org/en/) and [npm](http://blog.npmjs.org/post/85484771375/how-to-install-npm) installed first) | ||
|
||
|
||
#### Updates | ||
|
||
1. Unit test. Unit test. Unit test. Please take a look at how other unit tests are written, and you can't write too many tests. | ||
2. If there is a `*.spec.ts` file located in the components folder, update it to include a test for your change, if needed. If this file doesn't exist, please notify us. | ||
3. Run `npm run test` or `npm run test.watch` to make sure all tests are working, regardless if a test was added. | ||
|
||
|
||
## Commit Message Format | ||
|
||
We have very precise rules over how our git commit messages should be formatted. This leads to readable messages that are easy to follow when looking through the project history. We also use the git commit messages to generate our changelog. (Ok you got us, it's basically Angular's commit message format). | ||
|
||
`type(scope): subject` | ||
|
||
#### Type | ||
Must be one of the following: | ||
|
||
* **feat**: A new feature | ||
* **fix**: A bug fix | ||
* **docs**: Documentation only changes | ||
* **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc) | ||
* **refactor**: A code change that neither fixes a bug nor adds a feature | ||
* **perf**: A code change that improves performance | ||
* **test**: Adding missing tests | ||
* **chore**: Changes to the build process or auxiliary tools and libraries such as documentation generation | ||
|
||
#### Scope | ||
The scope can be anything specifying place of the commit change. For example `renderer`, `compiler`, etc. | ||
|
||
#### Subject | ||
The subject contains succinct description of the change: | ||
|
||
* use the imperative, present tense: "change" not "changed" nor "changes" | ||
* do not capitalize first letter | ||
* do not place a period `.` at the end | ||
* entire length of the commit message must not go over 50 characters | ||
* describe what the commit does, not what issue it relates to or fixes | ||
* **be brief, yet descriptive** - we should have a good understanding of what the commit does by reading the subject | ||
|
||
|
||
#### Adding Documentation | ||
|
||
Please see the [stencil-site](https://github.com/ionic-team/stencil-site) repo to update documentation. | ||
|
||
|
||
## License | ||
|
||
By contributing your code to the ionic-team/stencil GitHub Repository, you agree to license your contribution under the MIT license. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,32 @@ | ||
**Resources:** | ||
Before submitting an issue, please consult our [docs](https://stenciljs.com/). | ||
|
||
**Stencil version:** (run `npm list @stencil/core` from a terminal/cmd prompt and paste output below): | ||
|
||
``` | ||
insert the output from npm list @stencil/core here | ||
``` | ||
|
||
**I'm submitting a ...** (check one with "x") | ||
[ ] bug report | ||
[ ] feature request | ||
[ ] support request => Please do not submit support requests here, use one of these channels: https://forum.ionicframework.com/ or https://stencil-worldwide.slack.com | ||
|
||
**Current behavior:** | ||
<!-- Describe how the bug manifests. --> | ||
|
||
**Expected behavior:** | ||
<!-- Describe what the behavior would be without the bug. --> | ||
|
||
**Steps to reproduce:** | ||
<!-- If you are able to illustrate the bug or feature request with an example, please provide steps to reproduce and if possible a demo | ||
--> | ||
|
||
**Related code:** | ||
|
||
``` | ||
insert any relevant code here | ||
``` | ||
|
||
**Other information:** | ||
<!-- List any other information that is relevant to your issue. Stack traces, related issues, suggestions on how to fix, Stack Overflow links, forum links, etc. --> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
dist/ | ||
www/ | ||
|
||
*~ | ||
*.sw[mnpcod] | ||
*.log | ||
*.lock | ||
*.tmp | ||
*.tmp.* | ||
log.txt | ||
*.sublime-project | ||
*.sublime-workspace | ||
|
||
.idea/ | ||
.vscode/ | ||
.sass-cache/ | ||
.versions/ | ||
node_modules/ | ||
$RECYCLE.BIN/ | ||
|
||
.DS_Store | ||
Thumbs.db | ||
UserInterfaceState.xcuserstate | ||
.env |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
MIT License | ||
|
||
Copyright (c) 2017 Ionic | ||
|
||
Permission is hereby granted, free of charge, to any person obtaining a copy | ||
of this software and associated documentation files (the "Software"), to deal | ||
in the Software without restriction, including without limitation the rights | ||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
copies of the Software, and to permit persons to whom the Software is | ||
furnished to do so, subject to the following conditions: | ||
|
||
The above copyright notice and this permission notice shall be included in all | ||
copies or substantial portions of the Software. | ||
|
||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | ||
SOFTWARE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,56 @@ | ||
{ | ||
"name": "@engineerapart/stencil-lift", | ||
"version": "0.1.0", | ||
"description": "Stencil Lift - An SSR-safe data loading, serialization, and rehydration utility for Stencil apps, powered by Redux", | ||
"module": "dist/collection/index.js", | ||
"main": "dist/index.js", | ||
"types": "dist/types/components.d.ts", | ||
"collection": "dist/collection/collection-manifest.json", | ||
"files": [ | ||
"dist/" | ||
], | ||
"scripts": { | ||
"build": "stencil build", | ||
"dev": "sd concurrent \"stencil build --dev --watch\" \"stencil-dev-server\" ", | ||
"serve": "stencil-dev-server", | ||
"start": "npm run dev", | ||
"start:ssr": "NODE_ENV=production stencil build --ssr && NODE_ENV=production node server.js", | ||
"test": "jest", | ||
"test.watch": "jest --watch" | ||
}, | ||
"dependencies": { | ||
"redux": "^4.0.0" | ||
}, | ||
"devDependencies": { | ||
"@stencil/core": "^0.9.7", | ||
"@stencil/dev-server": "latest", | ||
"@stencil/utils": "latest", | ||
"@types/jest": "^23.0.0", | ||
"compression": "^1.7.2", | ||
"express": "^4.16.3", | ||
"jest": "^23.1.0" | ||
}, | ||
"repository": { | ||
"type": "git", | ||
"url": "git+https://github.com/ionic-team/stencil-component-starter.git" | ||
}, | ||
"author": "Ionic Team", | ||
"license": "MIT", | ||
"bugs": { | ||
"url": "https://github.com/ionic-team/stencil" | ||
}, | ||
"homepage": "https://github.com/ionic-team/stencil", | ||
"jest": { | ||
"transform": { | ||
"^.+\\.(ts|tsx)$": "<rootDir>/node_modules/@stencil/core/testing/jest.preprocessor.js" | ||
}, | ||
"testRegex": "(/__tests__/.*|\\.(test|spec))\\.(tsx?|jsx?)$", | ||
"moduleFileExtensions": [ | ||
"ts", | ||
"tsx", | ||
"js", | ||
"json", | ||
"jsx" | ||
] | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,78 @@ | ||
 | ||
|
||
# Stencil Component Starter | ||
|
||
This is a starter project for building a standalone Web Component using Stencil. | ||
|
||
Stencil is also great for building entire apps. For that, use the [stencil-app-starter](https://github.com/ionic-team/stencil-app-starter) instead. | ||
|
||
# Stencil | ||
|
||
Stencil is a compiler for building fast web apps using Web Components. | ||
|
||
Stencil combines the best concepts of the most popular frontend frameworks into a compile-time rather than run-time tool. Stencil takes TypeScript, JSX, a tiny virtual DOM layer, efficient one-way data binding, an asynchronous rendering pipeline (similar to React Fiber), and lazy-loading out of the box, and generates 100% standards-based Web Components that run in any browser supporting the Custom Elements v1 spec. | ||
|
||
Stencil components are just Web Components, so they work in any major framework or with no framework at all. | ||
|
||
## Getting Started | ||
|
||
To start building a new web component using Stencil, clone this repo to a new directory: | ||
|
||
```bash | ||
git clone https://github.com/ionic-team/stencil-component-starter.git my-component | ||
cd my-component | ||
git remote rm origin | ||
``` | ||
|
||
and run: | ||
|
||
```bash | ||
npm install | ||
npm start | ||
``` | ||
|
||
To watch for file changes during develop, run: | ||
|
||
```bash | ||
npm run dev | ||
``` | ||
|
||
To build the component for production, run: | ||
|
||
```bash | ||
npm run build | ||
``` | ||
|
||
To run the unit tests for the components, run: | ||
|
||
```bash | ||
npm test | ||
``` | ||
|
||
Need help? Check out our docs [here](https://stenciljs.com/docs/my-first-component). | ||
|
||
|
||
## Naming Components | ||
|
||
When creating new component tags, we recommend _not_ using `stencil` in the component name (ex: `<stencil-datepicker>`). This is because the generated component has little to nothing to do with Stencil; it's just a web component! | ||
|
||
Instead, use a prefix that fits your company or any name for a group of related components. For example, all of the Ionic generated web components use the prefix `ion`. | ||
|
||
|
||
## Using this component | ||
|
||
### Script tag | ||
|
||
- [Publish to NPM](https://docs.npmjs.com/getting-started/publishing-npm-packages) | ||
- Put a script tag similar to this `<script src='https://unpkg.com/[email protected]/dist/mycomponent.js'></script>` in the head of your index.html | ||
- Then you can use the element anywhere in your template, JSX, html etc | ||
|
||
### Node Modules | ||
- Run `npm install my-component --save` | ||
- Put a script tag similar to this `<script src='node_modules/my-component/dist/mycomponent.js'></script>` in the head of your index.html | ||
- Then you can use the element anywhere in your template, JSX, html etc | ||
|
||
### In a stencil-starter app | ||
- Run `npm install my-component --save` | ||
- Add an import to the npm packages `import my-component;` | ||
- Then you can use the element anywhere in your template, JSX, html etc |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
const express = require('express'); | ||
const stencil = require('@stencil/core/server'); | ||
const compression = require('compression'); | ||
|
||
// create the express app | ||
const app = express(); | ||
|
||
app.use(compression()); | ||
|
||
// set which port express it will be using | ||
const port = process.env.PORT || 3030; | ||
|
||
// load the stencil config & init server-side rendering html pages | ||
const config = stencil.initApp({ | ||
app, | ||
configPath: __dirname, | ||
}); | ||
|
||
// serve all static files from www directory | ||
app.use(express.static(config.wwwDir)); | ||
|
||
// start the server | ||
app.listen(port, () => config.logger.info(` 🍁 🍁 Stencil server started at http://localhost:${ port }`)); |
Oops, something went wrong.