|
1 | 1 | <!-- START .github/README_TEMPLATE/vscode-theme.template.md --> |
2 | | -<h1 align="center">falcon-theme</h1> |
3 | | - |
4 | | -<p align="center"> |
5 | | - <b>Dark Theme for Visual Studio Code designed specifically to work with React.js. This theme offers dark contrasts with colorful tones.</b><br /> |
6 | | - <sub>Created with ❤️ by luisfalconmx</sub> |
7 | | -</p> |
8 | | - |
9 | | -<br /> |
10 | | - |
11 | | -<p align="center"> |
12 | | - <img src="https://raw.githubusercontent.com/luisfalconmx/falcon-theme/main/.github/screenshot.png" alt="Falcon Theme" width="100%" /> |
13 | | -</p> |
14 | | - |
15 | | -<br /> |
16 | | - |
17 | | -## Installation |
18 | | - |
19 | | -Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter. |
20 | | - |
21 | | -```sh |
22 | | -ext install luisfalconmx.falcon-theme |
23 | | -``` |
24 | | - |
25 | | -## Contributing |
26 | | - |
27 | | -#### First clone the repository from github |
28 | | - |
29 | | -```bash |
30 | | -# HTTPS |
31 | | -https://github.com/luisfalconmx/falcon-theme.git |
32 | | -``` |
33 | | - |
34 | | -```bash |
35 | | -# SSH |
36 | | -[email protected]:luisfalconmx/falcon-theme.git |
37 | | -``` |
38 | | - |
39 | | -```bash |
40 | | -# GITHUB CLI |
41 | | -gh repo clone luisfalconmx/falcon-theme |
42 | | -``` |
43 | | - |
44 | | -#### Or fork this project clicking in the fork button set in head of this page. |
45 | | - |
46 | | - |
47 | | - |
48 | | -If you need help for this step check the next guide: |
49 | | -[https://docs.github.com/en/get-started/quickstart/fork-a-repo](https://docs.github.com/en/get-started/quickstart/fork-a-repo) |
50 | | - |
51 | | -#### Set node version with [nvm](https://github.com/nvm-sh/nvm#node-version-manager---) and install dependencies |
52 | | - |
53 | | -``` |
54 | | -nvm use |
55 | | -npm install |
56 | | -``` |
57 | | - |
58 | | -#### Finally you can start a local dev server with this command |
59 | | - |
60 | | -``` |
61 | | -npm start |
62 | | -``` |
63 | | - |
64 | | -#### If you need to check the code to find some errors and warnings, use the next commands |
65 | | - |
66 | | -``` |
67 | | -npm run lint |
68 | | -npm run stylelint |
69 | | -``` |
70 | | - |
71 | | -#### Also exists a command for apply code writing rules like indents, semicolons, etc. You can use the following command |
72 | | - |
73 | | -``` |
74 | | -npm run pretty |
75 | | -``` |
76 | | - |
77 | | -## Pull Requests |
78 | | - |
79 | | -#### To contribute to the project you need to create a new branch from the main branch |
80 | | - |
81 | | -```git |
82 | | -git checkout -b my-new-branch |
83 | | -``` |
84 | | - |
85 | | -#### Once you complete your project changes can be committed following the standard established by [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/). |
86 | | - |
87 | | -``` |
88 | | -<type>[optional scope]: <description> |
89 | | -
|
90 | | -[optional body] |
91 | | -
|
92 | | -[optional footer(s)] |
93 | | -``` |
94 | | - |
95 | | -### Examples |
96 | | - |
97 | | -#### Commit message with no body |
98 | | - |
99 | | -``` |
100 | | -docs: correct spelling of CHANGELOG |
101 | | -``` |
102 | | - |
103 | | -#### Commit message with scope |
104 | | - |
105 | | -``` |
106 | | -feat(lang): add Polish language |
107 | | -``` |
108 | | - |
109 | | -#### Commit message with description and breaking change footer |
110 | | - |
111 | | -``` |
112 | | -feat: allow provided config object to extend other configs |
113 | | -
|
114 | | -BREAKING CHANGE: `extends` key in config file is now used for extending other config files |
115 | | -``` |
116 | | - |
117 | | -If the code passes the tests and the commit message follows the standards set by [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/), you can commit your changes and upload them to the remote repository and you're ready to **create a Pull Request** to the **main branch**. |
118 | | - |
119 | | -If you need help to make a pull request, you can consult the following link: |
120 | | - |
121 | | -[https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) |
122 | | - |
123 | | -### Linters, Code Formater and other tools |
124 | | - |
125 | | -All changes to the project will be validated by creating a commit. These are the tools used to ensure that all code follows the quality standards defined for all contributions: |
126 | | - |
127 | | -- [ESLint](https://github.com/eslint/eslint) |
128 | | -- [Prettier](https://github.com/prettier/prettier) |
129 | | -- [Stylelint](https://github.com/stylelint/stylelint) |
130 | | -- [Husky](https://github.com/typicode/husky) |
131 | | -- [Commitlint](https://github.com/conventional-changelog/commitlint) |
132 | | -- [Lint Staged](https://github.com/okonet/lint-staged) |
133 | | - |
134 | | -### Join us in discussions |
135 | | - |
136 | | -We use GitHub Discussions to talk about all sorts of topics related to documentation and this site. For example: if you'd like to help troubleshooting a PR, have a great new idea, or want to share something amazing you've learned in our docs, join us in the [discussions](https://github.com/luisfalconmx/falcon-theme/discussions). |
137 | | - |
138 | | -## Roadmap |
139 | | - |
140 | | -Our project roadmap is where you can learn about what features we're working on, what stage they're in, and when we expect to bring them to you. Have any questions or comments about items on the roadmap? Share your feedback in [discussions](https://github.com/luisfalconmx/falcon-theme/discussions) section. |
141 | | - |
142 | | -Review the project roadmap. Maybe there is something amazing that you can contribute 😉 |
143 | | - |
144 | | -[https://github.com/luisfalconmx/falcon-theme/projects?type=beta](https://github.com/luisfalconmx/falcon-theme/projects?type=beta) |
145 | | - |
146 | | -## Releases |
147 | | - |
148 | | -To create a release it is necessary to prepare the project following these steps |
149 | | - |
150 | | -#### Create a new version with tag |
151 | | - |
152 | | -``` |
153 | | -npm version <version> |
154 | | -``` |
155 | | - |
156 | | -The above command receives as a parameter a specific version such as 1.4.0 or a version type defined by npm's [semantic versioning](https://docs.npmjs.com/about-semantic-versioning) which will automatically increment the number. |
157 | | - |
158 | | -These are the available types that can be used as a parameter: |
159 | | - |
160 | | -- **Patch** releases: `1.0` or `1.0.x` or `~1.0.4` |
161 | | -- **Minor** releases: `1` or `1.x` or `^1.0.4` |
162 | | -- **Major** releases: `*` or `x` |
163 | | - |
164 | | -### Examples |
165 | | - |
166 | | -``` |
167 | | -npm version 1.4.0 |
168 | | -``` |
169 | | - |
170 | | -``` |
171 | | -npm version minor |
172 | | -``` |
173 | | - |
174 | | -#### Upload the tag to the remote repository |
175 | | - |
176 | | -``` |
177 | | -git push origin <tag> |
178 | | -``` |
179 | | - |
180 | | -Check the complete list of all official releases published: |
181 | | -[https://github.com/luisfalconmx/falcon-theme/releases](https://github.com/luisfalconmx/falcon-theme/releases) |
182 | | - |
183 | | -## License |
184 | | - |
185 | | -This project is free and open-source software licensed under the [MIT License](https://github.com/luisfalconmx/falcon-theme/blob/main/LICENSE). |
186 | | - |
187 | | -Some contents like images, videos, documents and other multimedia files use your own licence and in case required atributtion this is mentioned in any part of this project like in the code or in the documentation. |
188 | | - |
189 | | -## Thanks ❤️ |
190 | | - |
191 | | -Thank you very much for visiting this repository, contributing amazing code and being part of this great community on github. |
192 | | - |
193 | | -If you want to support me you can visit my [Github Sponsors Profile](https://github.com/sponsors/luisfalconmx). Any support, no matter how small, motivates me to continue creating open source projects and share them with everyone :) |
194 | | - |
195 | 2 | <!-- END .github/README_TEMPLATE/vscode-theme.template.md --> |
0 commit comments