Описание
React Core Boilerplate является отправной точкой для создания универсальных/изоморфных веб-приложений React с помощью рендеринга ASP.NET Core 3 и серверной стороной. Все работает нормально из коробки. Это также полезно для новичков. Проект содержит поддельную систему авторизации. Таким образом, вы можете изменить его на личность или другое.
Версии TypeScript и JavaScript доступны.
Visual Studio Marketplace
Скриншоты
Изменения
ст. 2.0.3 (2020-07-03)
- Добавлена поддержка Docker. ?
- Добавлено предотвращение атаки XSS, благодаря Xuhaojun.
- Обновленные зависимости, удаленные неиспользованные пространства имен.
ст. 2.0.0 (2020-05-08)
- Мигрировал в .NET CORE 3.1 . ?
- Мигрировал на
Bootstrap 4 с использованием React-Bootstrap. - Мигрировал в Formik.
- Магазины
Redux мигрировали в Redux Toolkit для повышения разработки с Redux. Уменьшенный код. - Усовершенствования журнала и конфигурации
Serilog . - Добавлена поддержка HTTPS в
server-side rendering . - Добавлен редактируемый код состояния в маршрутах для SEO.
- Обновил некоторые зависимости.
- Установите исправления.
- Удаленные ненужные зависимости NPM.
ст. 1.7.1 (2019-06-02)
- Обновленные пакеты
React , Redux , React-Router и другие пакеты NPM, подключенные к ним. - Обновленные критические зависимости NPM.
- Удаленные ненужные зависимости NPM.
ст. 1.7.0 (2019-05-05)
- Репозитория реструктурация.
- Добавлена Javascript версия Core Corer Poilerplate React. ?
- Установите исправления.
- Обновленные критические зависимости.
ст. 1.6.3 (2019-03-19)
- Удален
image-webpack-loader из-за нестабильности.
ст. 1.6.2 (2019-03-15)
- Установлен стабильный плагин
Terser . - Обновленные
React и другие пакеты для него (вкл. Типы). - Обновлен
WebPack . - Обновленная конфигурация WebPack для режима разработки.
ст. 1.6.0 (2019-03-13)
- Обновленная зависимость
.NET Core с v. 2.2 . - Обновленные критические пакеты NPM.
- Обновленные зависимости
WebPack . - Улучшенные конфигурации поставщика
WebPack и пакета. - Улучшенный файл
.csproj для создания и публикации сценариев. - Фиксированная карта источника в режиме разработки.
- Фиксированная компиляция пакета в производственном режиме.
- Другая стабильность исправляет.
ст. 1.5.4 (2019-02-04)
- Добавил несколько незначительных функций.
- Исправление ошибок:
collapsing of the Bootstrap navigation bar , fixed controller and frontend's service in person update case . - Обновленные зависимости.
ст. 1.5.3 (2018-12-04)
- Добавлены полифиллы для поддержки IE9, IE11:
@babel/polyfill , custom-event-polyfill . - Обновленные зависимости.
ст. 1.5.2 (2018-12-01)
- Добавлен полнотекстовый живой поиск в пример.
- Добавлены плагины WebPack:
case-sensitive-paths-webpack-plugin , react-dev-utils - Добавлены плагины с примерами:
awesome-debounce-promise , чтобы предотвратить частые запросы в Live Search, formik для создания форм в React без слез. - Исправлены некоторые функциональные и текстовые ошибки.
ст. 1.5.0 (1) (2018-11-07)
- Добавлен
hosting.json , который содержит настройки хостинга и будет использоваться в производственной сборке. - Добавлено пакет
bind-decorator и примерами с ним. - Ускорение здания пакета WebPack.
- Обновленный пакет домена-ожидания. Это обновление позволяет предотвратить призыв к изоморфным запросам избрать дважды (на сервере Prerender и после него - на стороне клиента).
- Обновленный пакет Redux-Thunk.
- Добавлены новые компоненты React для предотвращения головной боли при создании веб -приложений:
ModalComponent , Input , MultiSelect , Form . Эти компоненты используются в примерах.
ст. 1.4.5 (2018-11-02)
- Добавлена новая функция позволяет веб -приложению обмениваться файлами cookie браузера с узлами. Теперь SSR генерирует HTML -код для аутентифицированных пользователей и делает аутентифицированные изоморфные запросы.
- Добавлен метод
sendFormData в ServiceBase.ts , который позволяет загружать файлы на сервер.
ст. 1.3.5 (2018-10-26)
- Обновленные пакеты NPM:
react , redux , react-router . - Заменен из-за снижения
react-router-redux рек connected-react-router . - Фиксированный компонент
Loader , у которого были проблемы в некоторых случаях.
ст. 1.3.2 (2018-10-25)
- Удалили неиспользованные пакеты NPM.
- Добавлен пакет-lock.json.
- Фиксированный проект.
ст. 1.3.0 (2018-10-22)
- Обновленный пакет React.
- Добавлена компонент
AppComponent , который позволяет вам выполнить «обновление силы» компонентов « Loader » (для Ex. Component в LoginPage ). - Добавлены Logger Serilog, который войдет в файлы (
logs/ каталог), а также в облачный провайдер Azure.
ст. 1.2.1 (2018-10-20)
- Компонент с фиксированным
Loader , который в некоторых случаях работал неправильно с SSR.
ст. 1.2.0 (2018-10-18)
- Обновленная зависимость пакета «ASP.NET Core» из -за уязвимости.
- Добавлена функция, которая позволяет вам передавать объекты JSON в запрос на URL для методов GET и удаления.
ст. 1.1.0 (2018-10-16)
- Фиксированный компонент
AppRoute . Решенная проблема с прохождением параметров в компоненты из React Router. Если вы хотите исправить это вручную, посмотрите здесь.
Использование
Установка
- Установите новейшие .NET CORE SDK и время выполнения по ссылке.
- Установите последний стабильный узел.js.
- При первом забеге вы должны закрыть проект, если он работает в Visual Studio или в другой IDE. Открыть папку проекта в консоли и запустить команду
npm install . - Выполните следующую команду для разработки в каталоге вашего проекта. Он составят основной и продавец.
- Если вы используете Visual Studio 20xx, вместо
IIS Express выберите YourProjectName или ReactCoreBoilerplate : нажмите на стрелку вниз вблизи IIS Express и выберите Docker или другой вариант. - Создать и запустить проект. Он начнется в консоли Windows.
Изменить конфигурацию поставщика WebPack
Если вы измените конфигурацию поставщика WebPack, вы должны вручную перекомпилировать пакет поставщика. Выполнить следующую команду в каталоге вашего проекта, чтобы сделать это:
Беги с докером
Visual Studio 20xx
Просто выберите опцию Docker на панели инструментов.
Создайте контейнер
Выполните следующую команду в каталоге вашего проекта:
docker build -t [my image name] .
где [my image name] - это имя вашего изображения Docker.
Запустите производственный контейнер в Windows с поддержкой HTTPS (для теста)
- Доверьтесь сертификату разработки HTTPS Core ASP.NET в Windows и MacOS:
dotnet dev-certs https -ep %USERPROFILE% . aspnet h ttps a spnetapp.pfx -p [my password]
Где [my password] - ваш пароль.
2. Выполнить:
dotnet dev-certs https --trust
- Создайте свой контейнер.
- Выполнять:
docker run --rm -it -p 7000:7000 -p 7001:7001 -e ASPNETCORE_URLS= " https://+;http://+ " -e ASPNETCORE_Kestrel__Certificates__Default__Password= " [my password] " -e ASPNETCORE_Kestrel__Certificates__Default__Path=/https/aspnetapp.pfx -v %USERPROFILE% . aspnet h ttps:/https/ [my image name]
Где [my password] - ваш пароль сертификата (с 1 -го шага), [my image name] - Имя изображения вашего Docker.
Элементы
Сторонние библиотеки:
- TypeScript - All Frontend на основе TypeScript.
- Fork-ts-checker-webpack-plugin-плагин Webpack, который запускает шахтеров типа типа в отдельном процессе.
- React - Основная библиотека, которая работала как изоморфная.
- React Router - маршрутизатор для React.
- React -Bootstrap - Bootstrap 4 для React.
- React -Helmet - Изоморфные помощники SEO.
- Redux - магазин.
- Redux Toolkit - библиотека для повышения разработки с Redux.
- Formik - Библиотека для форм строительства для React.
- Связанный маршрутизатор React - Redux связывание для React Router.
- Sass - CSS препроцессор.
- Webpack 4 - Бундлер.
- Axios - изоморфный извлечение утилит.
- TS-NAMEOF-позволяет вам использовать имена входов, защищенных типами в форме.
- JSON-TO-URL-позволяет вам передавать объекты JSON на URL-запрос для методов GET и DELETE.
- Serilog - позволяет войти в файлы (
logs/ каталог), а также в облачный провайдер Azure.
Собственные библиотеки / фиксированные вилки:
- Домен-wait-замена доменной задачи с помощью асинхронной/ожидаемой поддержки и новых функций.
- Nval-jquery-validation-подобный валидатор ванили JS.
- NVAL -TIPPY - Vanilla JS Validation с потрясающими подсказками.
- Nserializejson - гибкая форма для сериализатора JSON на основе ванили JS.
Проблемы
Известные проблемы
Ошибка в ./clientapp/styles/loaders/xxx.scss (./node_modules/css-loader/dist/cjs.js! [...]): ошибка: enoent: нет такого файла или каталога, Scandir 'xxx node_modules node-sass vendor'
Выполните npm i и npm rebuild node-sass в каталоге вашего проекта.
Замена горячего модуля WebPack [HMR] не работает с IIS
Будет исправлен. Вместо этого используйте Kestrel для разработки.
Http error 500
Наверное, у вас нет последней версии node.js.
Ошибка HTTP 502,5
Вы должны установить новейшие «ASP.NET CORE SDK» и «Продолжительность и хостинг», используя эту ссылку: https://www.microsoft.com/net/download/dotnet-core/2.1
Http error 500 при размещении в Azure
Установите «webse_node_default_version» на 6.11.2 в «Настройках приложения» в Azure.
Ошибки при запуске в режиме разработки после публикации
Выполнить npm run build:dev Command в режиме проекта.
Другие проблемы
- Если у вас будет какая -либо проблема с началом проекта, вы можете увидеть ошибки в журналах ("/logs". Пожалуйста, сделайте это до того, как Open - проблема на GitHub. Не забудьте упомянуть версию Corer Poilerplate React (
JavaScript или TypeScript )
Лицензия
Грань