[
{
"path": ".gitattributes",
"content": "###############################################################################\n# Set default behavior to automatically normalize line endings.\n###############################################################################\n* text=auto\n\n###############################################################################\n# Set default behavior for command prompt diff.\n#\n# This is need for earlier builds of msysgit that does not have it on by\n# default for csharp files.\n# Note: This is only used by command line\n###############################################################################\n#*.cs diff=csharp\n\n###############################################################################\n# Set the merge driver for project and solution files\n#\n# Merging from the command prompt will add diff markers to the files if there\n# are conflicts (Merging from VS is not affected by the settings below, in VS\n# the diff markers are never inserted). Diff markers may cause the following \n# file extensions to fail to load in VS. An alternative would be to treat\n# these files as binary and thus will always conflict and require user\n# intervention with every merge. To do so, just uncomment the entries below\n###############################################################################\n#*.sln merge=binary\n#*.csproj merge=binary\n#*.vbproj merge=binary\n#*.vcxproj merge=binary\n#*.vcproj merge=binary\n#*.dbproj merge=binary\n#*.fsproj merge=binary\n#*.lsproj merge=binary\n#*.wixproj merge=binary\n#*.modelproj merge=binary\n#*.sqlproj merge=binary\n#*.wwaproj merge=binary\n\n###############################################################################\n# behavior for image files\n#\n# image files are treated as binary by default.\n###############################################################################\n#*.jpg binary\n#*.png binary\n#*.gif binary\n*.ico binary\n\n###############################################################################\n# diff behavior for common document formats\n# \n# Convert binary document formats to text before diffing them. This feature\n# is only available from the command line. Turn it on by uncommenting the \n# entries below.\n###############################################################################\n#*.doc diff=astextplain\n#*.DOC diff=astextplain\n#*.docx diff=astextplain\n#*.DOCX diff=astextplain\n#*.dot diff=astextplain\n#*.DOT diff=astextplain\n#*.pdf diff=astextplain\n#*.PDF diff=astextplain\n#*.rtf diff=astextplain\n#*.RTF diff=astextplain\n"
},
{
"path": ".github/ISSUE_TEMPLATE.md",
"content": "\n\n\n"
},
{
"path": ".github/PULL_REQUEST_TEMPLATE.md",
"content": "\n\n\n"
},
{
"path": ".gitignore",
"content": "_build/\n_site/\nProperties/\n\n# Use git add -f to force override .sln when required. Not needed in most cases.\n# git add -f myProj.sln\n*.sln\n\nProject_Readme.html\n\n## Ignore Visual Studio temporary files, build results, and\n## files generated by popular Visual Studio add-ons.\n\n# User-specific files\n*.suo\n*.user\n*.userosscache\n*.sln.docstates\n*.vscode/\n# User-specific files (MonoDevelop/Xamarin Studio)\n*.userprefs\n\n# Build results\n[Dd]ebug/\n[Dd]ebugPublic/\n[Rr]elease/\n[Rr]eleases/\nx64/\nx86/\nbuild/\nbld/\n[Bb]in/\n[Oo]bj/\n\n# Visual Studo 2015 cache/options directory\n.vs/\n\n# MSTest test Results\n[Tt]est[Rr]esult*/\n[Bb]uild[Ll]og.*\n\n# NUNIT\n*.VisualState.xml\nTestResult.xml\n\n# Build Results of an ATL Project\n[Dd]ebugPS/\n[Rr]eleasePS/\ndlldata.c\n\n*_i.c\n*_p.c\n*_i.h\n*.ilk\n*.meta\n*.obj\n*.pch\n*.pdb\n*.pgc\n*.pgd\n*.rsp\n*.sbr\n*.tlb\n*.tli\n*.tlh\n*.tmp\n*.tmp_proj\n*.log\n*.vspscc\n*.vssscc\n.builds\n*.pidb\n*.svclog\n*.scc\n\n# Chutzpah Test files\n_Chutzpah*\n\n# Visual C++ cache files\nipch/\n*.aps\n*.ncb\n*.opensdf\n*.sdf\n*.cachefile\n\n# Visual Studio profiler\n*.psess\n*.vsp\n*.vspx\n\n# TFS 2012 Local Workspace\n$tf/\n\n# Guidance Automation Toolkit\n*.gpState\n\n# ReSharper is a .NET coding add-in\n_ReSharper*/\n*.[Rr]e[Ss]harper\n*.DotSettings.user\n\n# JustCode is a .NET coding addin-in\n.JustCode\n\n# TeamCity is a build add-in\n_TeamCity*\n\n# DotCover is a Code Coverage Tool\n*.dotCover\n\n# NCrunch\n_NCrunch_*\n.*crunch*.local.xml\n\n# MightyMoose\n*.mm.*\nAutoTest.Net/\n\n# Web workbench (sass)\n.sass-cache/\n\n# Installshield output folder\n[Ee]xpress/\n\n# DocProject is a documentation generator add-in\nDocProject/buildhelp/\nDocProject/Help/*.HxT\nDocProject/Help/*.HxC\nDocProject/Help/*.hhc\nDocProject/Help/*.hhk\nDocProject/Help/*.hhp\nDocProject/Help/Html2\nDocProject/Help/html\n\n# Click-Once directory\npublish/\n\n# Publish Web Output\n*.[Pp]ublish.xml\n*.azurePubxml\n# TODO: Comment the next line if you want to checkin your web deploy settings \n# but database connection strings (with potential passwords) will be unencrypted\n*.pubxml\n*.publishproj\n\n# NuGet Packages\n*.nupkg\n# The packages folder can be ignored because of Package Restore\n**/packages/*\n# except build/, which is used as an MSBuild target.\n!**/packages/build/\n# Uncomment if necessary however generally it will be regenerated when needed\n#!**/packages/repositories.config\n\n# Windows Azure Build Output\ncsx/\n*.build.csdef\n\n# Windows Store app package directory\nAppPackages/\n\n# Others\n*.[Cc]ache\nClientBin/\n[Ss]tyle[Cc]op.*\n~$*\n*~\n*.dbmdl\n*.dbproj.schemaview\n*.pfx\n*.publishsettings\nnode_modules/\nbower_components/\n\n# RIA/Silverlight projects\nGenerated_Code/\n\n# Backup & report files from converting an old project file\n# to a newer Visual Studio version. Backup files are not needed,\n# because we have git ;-)\n_UpgradeReport_Files/\nBackup*/\nUpgradeLog*.XML\nUpgradeLog*.htm\n\n# SQL Server files\n*.mdf\n*.ldf\n\n# Business Intelligence projects\n*.rdl.data\n*.bim.layout\n*.bim_*.settings\n\n# Microsoft Fakes\nFakesAssemblies/\n\n# Node.js Tools for Visual Studio\n.ntvs_analysis.dat\n\n# Visual Studio 6 build log\n*.plg\n\n# Visual Studio 6 workspace options file\n*.opt\n\nproject.lock.json\n**/sample/**/wwwroot/lib/\n**/samples/**/wwwroot/lib/\n__pycache__/\n\n#Mac OSX \n.DS_Store\n\n# Windows thumbnail cache files\nThumbs.db\n\n# DocFx\napi/.manifest\n_exported_templates/\n"
},
{
"path": "CNAME",
"content": "blazor.net\n"
},
{
"path": "CONTRIBUTING.md",
"content": "# Contributing to the Blazor documentation\n\nThis document covers the process for contributing to the articles and code samples that are hosted at http://blazor.net. Contributions may be as simple as typo corrections or as complex as new articles.\n\n## How to make a simple correction or suggestion\n\nArticles are stored in the repository as markdown files. Simple changes to the content of a markdown file can be made in the browser by selecting the **Improve this Doc** link in the upper-right corner of the browser window, editing the doc on GitHub, and then submitting a pull request (PR) for the change. We will review the PR and accept it or suggest changes.\n\n## How to make a more complex submission\n\nYou'll need a basic understanding of [Git and GitHub.com](https://guides.github.com/activities/hello-world/).\n\n* Open an [issue](https://github.com/aspnet/Blazor.Docs/issues/new) describing what you want to do, such as change an existing article or create a new one. Wait for approval from the team before you invest much time. We usually request an outline for a new topic proposal.\n* Fork the [aspnet/Blazor.Docs](https://github.com/aspnet/Blazor.Docs/) repo and create a branch for your changes.\n* Submit a pull request (PR) to master with your changes.\n* If your PR has the label 'cla-required' assigned, [complete the Contribution License Agreement (CLA)](https://cla.dotnetfoundation.org/)\n* Respond to PR feedback.\n\n## Markdown syntax\n\nArticles are written in [DocFx-flavored Markdown (DFM)](http://dotnet.github.io/docfx/spec/docfx_flavored_markdown.html), which is a superset of [GitHub-flavored Markdown (GFM)](https://guides.github.com/features/mastering-markdown/). For examples of DFM syntax for UI features commonly used in the Blazor documentation, see [Metadata and Markdown Template](https://github.com/dotnet/docs/blob/master/styleguide/template.md) in the .NET repo style guide. \n\n## Folder structure conventions\n\nFor each markdown file, there may be a folder for images and a folder for sample code. For example, if the article is *tutorials/build-your-first-blazor-app.md*, the images are in *tutorials/build-your-first-blazor-app/\\_static* and the sample app project files are in *tutorials/build-your-first-blazor-app/samples/2.x* (for a 2.x versioned sample). An image in the *tutorials/build-your-first-blazor-app.md* file is rendered by the following markdown.\n\n```\n\n```\n\n**All** images should have [alt text](https://wikipedia.org/wiki/Alt_attribute).\n\nMarkdown file names and image file names should be all lower case. Use dashes to separate words in file names.\n\n## Internal links\n\nInternal links should use the `uid` of the target article with an xref link:\n\n```\n[link_text](xref:uid_of_the_topic)\n```\n\nFor more informatin, see the [DocFX Cross Reference](http://dotnet.github.io/docfx/spec/docfx_flavored_markdown.html#cross-reference).\n\n## Code snippets\n\nArticles frequently contain code snippets to illustrate points. DFM lets you copy code into the Markdown file or refer to a separate code file. We prefer to use separate code files whenever possible to minimize the chance of errors in the code. The code files should be stored in the repo using the folder structure described above for sample projects. \n\nHere are some examples of [DFM code snippet syntax](http://dotnet.github.io/docfx/spec/docfx_flavored_markdown.html#code-snippet) that would be used in a *tutorials/build-your-first-blazor-app.md* file.\n\nTo render an entire code file as a snippet:\n\n```\n[!code-csharp[Main](tutorials/build-your-first-blazor-app/sample/Program.cs)]\n```\n\nTo render a portion of a file as a snippet by using line numbers:\n\n```\n[!code-csharp[Main](tutorials/build-your-first-blazor-app/sample/Program.cs?range=1-10,20,30,40-50]\n[!code-html[Main](tutorials/build-your-first-blazor-app/sample/Pages/Index.cshtml?range=1-10,20,30,40-50]\n```\n\nFor C# snippets, you can reference a [C# region](https://docs.microsoft.com/dotnet/csharp/language-reference/preprocessor-directives/preprocessor-region). Whenever possible, use regions rather than line numbers because line numbers in a code file tend to change and become out of sync with line number references in markdown. C# regions can be nested; and if you reference the outer region, the inner `#region` and `#endregion` directives aren't rendered in a snippet. \n\nTo render a C# region named \"snippet_Example\":\n\n```\n[!code-csharp[Main](tutorials/build-your-first-blazor-app/sample/Program.cs?name=snippet_Example)]\n```\n\nTo highlight selected lines in a rendered snippet (usually renders as yellow background color):\n\n```\n[!code-csharp[Main](tutorials/build-your-first-blazor-app/sample/Program.cs?name=snippet_Example&highlight=1-3,10,20-25)]\n[!code-csharp[Main](tutorials/build-your-first-blazor-app/sample/Program.cs?range=10-20&highlight=1-3]\n[!code-html[Main](tutorials/build-your-first-blazor-app/sample/Pages/Index.cshtml?range=10-20&highlight=1-3]\n[!code-javascript[Main](tutorials/build-your-first-blazor-app/sample/BlazorApp1.csproj?range=10-20&highlight=1-3]\n```\n\n## Test your changes with DocFX\n\nTest your changes with the [DocFX command-line tool](https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html#2-use-docfx-as-a-command-line-tool), which creates a locally-hosted version of the site. DocFX doesn't render style and site extensions created for docs.microsoft.com.\n\nDocFX requires the .NET Framework on Windows or Mono for Linux/macOS. \n\n### Windows instructions\n\n* Download and unzip *docfx.zip* from [DocFX releases](https://github.com/dotnet/docfx/releases).\n* Add DocFX to your PATH.\n* In a console window, navigate to root of the repo (where the *docfx.json* file resides) and run the following command:\n\n ```\n docfx --serve\n ```\n* In a browser, navigate to `http://localhost:8080`.\n\n### Mono instructions\n\n* Install Mono via Homebrew:\n\n ```\n brew install mono\n ```\n* Download the [latest version of DocFX](https://github.com/dotnet/docfx/releases).\n* Extract the archive to *$HOME/bin/docfx*.\n* Create a pair of aliases for **docfx** in a bash shell. The first alias is used to build the documentation. The second alias is used to build and serve the documentation.\n\n ```\n alias docfx='mono $HOME/bin/docfx/docfx.exe'\n alias docfx-serve='mono $HOME/bin/docfx/docfx.exe --serve'\n ```\n* Execute `docfx` from the root of the repo to build the site. Execute `docfx-serve` to view the site at `http://localhost:8080`.\n\n## Voice and tone\n\nOur goal is to write documentation that is easily understandable by the widest possible audience. To that end, we've established guidelines for writing style that we ask our contributors to follow. For more information, see [Voice and tone guidelines](https://github.com/dotnet/docs/blob/master/styleguide/voice-tone.md) in the .NET repo.\n\n## Microsoft Writing Style Guide\n\nThe [Microsoft Writing Style Guide](https://docs.microsoft.com/style-guide/welcome/) provides writing style and terminology guidance for all forms of technology communication, including the Blazor documentation.\n"
},
{
"path": "LICENSE",
"content": "Attribution 4.0 International\n\n=======================================================================\n\nCreative Commons Corporation (\"Creative Commons\") is not a law firm and\ndoes not provide legal services or legal advice. Distribution of\nCreative Commons public licenses does not create a lawyer-client or\nother relationship. Creative Commons makes its licenses and related\ninformation available on an \"as-is\" basis. Creative Commons gives no\nwarranties regarding its licenses, any material licensed under their\nterms and conditions, or any related information. Creative Commons\ndisclaims all liability for damages resulting from their use to the\nfullest extent possible.\n\nUsing Creative Commons Public Licenses\n\nCreative Commons public licenses provide a standard set of terms and\nconditions that creators and other rights holders may use to share\noriginal works of authorship and other material subject to copyright\nand certain other rights specified in the public license below. The\nfollowing considerations are for informational purposes only, are not\nexhaustive, and do not form part of our licenses.\n\n Considerations for licensors: Our public licenses are\n intended for use by those authorized to give the public\n permission to use material in ways otherwise restricted by\n copyright and certain other rights. Our licenses are\n irrevocable. Licensors should read and understand the terms\n and conditions of the license they choose before applying it.\n Licensors should also secure all rights necessary before\n applying our licenses so that the public can reuse the\n material as expected. Licensors should clearly mark any\n material not subject to the license. This includes other CC-\n licensed material, or material used under an exception or\n limitation to copyright. More considerations for licensors:\n\twiki.creativecommons.org/Considerations_for_licensors\n\n Considerations for the public: By using one of our public\n licenses, a licensor grants the public permission to use the\n licensed material under specified terms and conditions. If\n the licensor's permission is not necessary for any reason--for\n example, because of any applicable exception or limitation to\n copyright--then that use is not regulated by the license. Our\n licenses grant only permissions under copyright and certain\n other rights that a licensor has authority to grant. Use of\n the licensed material may still be restricted for other\n reasons, including because others have copyright or other\n rights in the material. A licensor may make special requests,\n such as asking that all changes be marked or described.\n Although not required by our licenses, you are encouraged to\n respect those requests where reasonable. More_considerations\n for the public: \n\twiki.creativecommons.org/Considerations_for_licensees\n\n=======================================================================\n\nCreative Commons Attribution 4.0 International Public License\n\nBy exercising the Licensed Rights (defined below), You accept and agree\nto be bound by the terms and conditions of this Creative Commons\nAttribution 4.0 International Public License (\"Public License\"). To the\nextent this Public License may be interpreted as a contract, You are\ngranted the Licensed Rights in consideration of Your acceptance of\nthese terms and conditions, and the Licensor grants You such rights in\nconsideration of benefits the Licensor receives from making the\nLicensed Material available under these terms and conditions.\n\n\nSection 1 -- Definitions.\n\n a. Adapted Material means material subject to Copyright and Similar\n Rights that is derived from or based upon the Licensed Material\n and in which the Licensed Material is translated, altered,\n arranged, transformed, or otherwise modified in a manner requiring\n permission under the Copyright and Similar Rights held by the\n Licensor. For purposes of this Public License, where the Licensed\n Material is a musical work, performance, or sound recording,\n Adapted Material is always produced where the Licensed Material is\n synched in timed relation with a moving image.\n\n b. Adapter's License means the license You apply to Your Copyright\n and Similar Rights in Your contributions to Adapted Material in\n accordance with the terms and conditions of this Public License.\n\n c. Copyright and Similar Rights means copyright and/or similar rights\n closely related to copyright including, without limitation,\n performance, broadcast, sound recording, and Sui Generis Database\n Rights, without regard to how the rights are labeled or\n categorized. For purposes of this Public License, the rights\n specified in Section 2(b)(1)-(2) are not Copyright and Similar\n Rights.\n\n d. Effective Technological Measures means those measures that, in the\n absence of proper authority, may not be circumvented under laws\n fulfilling obligations under Article 11 of the WIPO Copyright\n Treaty adopted on December 20, 1996, and/or similar international\n agreements.\n\n e. Exceptions and Limitations means fair use, fair dealing, and/or\n any other exception or limitation to Copyright and Similar Rights\n that applies to Your use of the Licensed Material.\n\n f. Licensed Material means the artistic or literary work, database,\n or other material to which the Licensor applied this Public\n License.\n\n g. Licensed Rights means the rights granted to You subject to the\n terms and conditions of this Public License, which are limited to\n all Copyright and Similar Rights that apply to Your use of the\n Licensed Material and that the Licensor has authority to license.\n\n h. Licensor means the individual(s) or entity(ies) granting rights\n under this Public License.\n\n i. Share means to provide material to the public by any means or\n process that requires permission under the Licensed Rights, such\n as reproduction, public display, public performance, distribution,\n dissemination, communication, or importation, and to make material\n available to the public including in ways that members of the\n public may access the material from a place and at a time\n individually chosen by them.\n\n j. Sui Generis Database Rights means rights other than copyright\n resulting from Directive 96/9/EC of the European Parliament and of\n the Council of 11 March 1996 on the legal protection of databases,\n as amended and/or succeeded, as well as other essentially\n equivalent rights anywhere in the world.\n\n k. You means the individual or entity exercising the Licensed Rights\n under this Public License. Your has a corresponding meaning.\n\n\nSection 2 -- Scope.\n\n a. License grant.\n\n 1. Subject to the terms and conditions of this Public License,\n the Licensor hereby grants You a worldwide, royalty-free,\n non-sublicensable, non-exclusive, irrevocable license to\n exercise the Licensed Rights in the Licensed Material to:\n\n a. reproduce and Share the Licensed Material, in whole or\n in part; and\n\n b. produce, reproduce, and Share Adapted Material.\n\n 2. Exceptions and Limitations. For the avoidance of doubt, where\n Exceptions and Limitations apply to Your use, this Public\n License does not apply, and You do not need to comply with\n its terms and conditions.\n\n 3. Term. The term of this Public License is specified in Section\n 6(a).\n\n 4. Media and formats; technical modifications allowed. The\n Licensor authorizes You to exercise the Licensed Rights in\n all media and formats whether now known or hereafter created,\n and to make technical modifications necessary to do so. The\n Licensor waives and/or agrees not to assert any right or\n authority to forbid You from making technical modifications\n necessary to exercise the Licensed Rights, including\n technical modifications necessary to circumvent Effective\n Technological Measures. For purposes of this Public License,\n simply making modifications authorized by this Section 2(a)\n (4) never produces Adapted Material.\n\n 5. Downstream recipients.\n\n a. Offer from the Licensor -- Licensed Material. Every\n recipient of the Licensed Material automatically\n receives an offer from the Licensor to exercise the\n Licensed Rights under the terms and conditions of this\n Public License.\n\n b. No downstream restrictions. You may not offer or impose\n any additional or different terms or conditions on, or\n apply any Effective Technological Measures to, the\n Licensed Material if doing so restricts exercise of the\n Licensed Rights by any recipient of the Licensed\n Material.\n\n 6. No endorsement. Nothing in this Public License constitutes or\n may be construed as permission to assert or imply that You\n are, or that Your use of the Licensed Material is, connected\n with, or sponsored, endorsed, or granted official status by,\n the Licensor or others designated to receive attribution as\n provided in Section 3(a)(1)(A)(i).\n\n b. Other rights.\n\n 1. Moral rights, such as the right of integrity, are not\n licensed under this Public License, nor are publicity,\n privacy, and/or other similar personality rights; however, to\n the extent possible, the Licensor waives and/or agrees not to\n assert any such rights held by the Licensor to the limited\n extent necessary to allow You to exercise the Licensed\n Rights, but not otherwise.\n\n 2. Patent and trademark rights are not licensed under this\n Public License.\n\n 3. To the extent possible, the Licensor waives any right to\n collect royalties from You for the exercise of the Licensed\n Rights, whether directly or through a collecting society\n under any voluntary or waivable statutory or compulsory\n licensing scheme. In all other cases the Licensor expressly\n reserves any right to collect such royalties.\n\n\nSection 3 -- License Conditions.\n\nYour exercise of the Licensed Rights is expressly made subject to the\nfollowing conditions.\n\n a. Attribution.\n\n 1. If You Share the Licensed Material (including in modified\n form), You must:\n\n a. retain the following if it is supplied by the Licensor\n with the Licensed Material:\n\n i. identification of the creator(s) of the Licensed\n Material and any others designated to receive\n attribution, in any reasonable manner requested by\n the Licensor (including by pseudonym if\n designated);\n\n ii. a copyright notice;\n\n iii. a notice that refers to this Public License;\n\n iv. a notice that refers to the disclaimer of\n warranties;\n\n v. a URI or hyperlink to the Licensed Material to the\n extent reasonably practicable;\n\n b. indicate if You modified the Licensed Material and\n retain an indication of any previous modifications; and\n\n c. indicate the Licensed Material is licensed under this\n Public License, and include the text of, or the URI or\n hyperlink to, this Public License.\n\n 2. You may satisfy the conditions in Section 3(a)(1) in any\n reasonable manner based on the medium, means, and context in\n which You Share the Licensed Material. For example, it may be\n reasonable to satisfy the conditions by providing a URI or\n hyperlink to a resource that includes the required\n information.\n\n 3. If requested by the Licensor, You must remove any of the\n information required by Section 3(a)(1)(A) to the extent\n reasonably practicable.\n\n 4. If You Share Adapted Material You produce, the Adapter's\n License You apply must not prevent recipients of the Adapted\n Material from complying with this Public License.\n\n\nSection 4 -- Sui Generis Database Rights.\n\nWhere the Licensed Rights include Sui Generis Database Rights that\napply to Your use of the Licensed Material:\n\n a. for the avoidance of doubt, Section 2(a)(1) grants You the right\n to extract, reuse, reproduce, and Share all or a substantial\n portion of the contents of the database;\n\n b. if You include all or a substantial portion of the database\n contents in a database in which You have Sui Generis Database\n Rights, then the database in which You have Sui Generis Database\n Rights (but not its individual contents) is Adapted Material; and\n\n c. You must comply with the conditions in Section 3(a) if You Share\n all or a substantial portion of the contents of the database.\n\nFor the avoidance of doubt, this Section 4 supplements and does not\nreplace Your obligations under this Public License where the Licensed\nRights include other Copyright and Similar Rights.\n\n\nSection 5 -- Disclaimer of Warranties and Limitation of Liability.\n\n a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE\n EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS\n AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF\n ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,\n IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,\n WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR\n PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,\n ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT\n KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT\n ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.\n\n b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE\n TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,\n NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,\n INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,\n COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR\n USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN\n ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR\n DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR\n IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.\n\n c. The disclaimer of warranties and limitation of liability provided\n above shall be interpreted in a manner that, to the extent\n possible, most closely approximates an absolute disclaimer and\n waiver of all liability.\n\n\nSection 6 -- Term and Termination.\n\n a. This Public License applies for the term of the Copyright and\n Similar Rights licensed here. However, if You fail to comply with\n this Public License, then Your rights under this Public License\n terminate automatically.\n\n b. Where Your right to use the Licensed Material has terminated under\n Section 6(a), it reinstates:\n\n 1. automatically as of the date the violation is cured, provided\n it is cured within 30 days of Your discovery of the\n violation; or\n\n 2. upon express reinstatement by the Licensor.\n\n For the avoidance of doubt, this Section 6(b) does not affect any\n right the Licensor may have to seek remedies for Your violations\n of this Public License.\n\n c. For the avoidance of doubt, the Licensor may also offer the\n Licensed Material under separate terms or conditions or stop\n distributing the Licensed Material at any time; however, doing so\n will not terminate this Public License.\n\n d. Sections 1, 5, 6, 7, and 8 survive termination of this Public\n License.\n\n\nSection 7 -- Other Terms and Conditions.\n\n a. The Licensor shall not be bound by any additional or different\n terms or conditions communicated by You unless expressly agreed.\n\n b. Any arrangements, understandings, or agreements regarding the\n Licensed Material not stated herein are separate from and\n independent of the terms and conditions of this Public License.\n\n\nSection 8 -- Interpretation.\n\n a. For the avoidance of doubt, this Public License does not, and\n shall not be interpreted to, reduce, limit, restrict, or impose\n conditions on any use of the Licensed Material that could lawfully\n be made without permission under this Public License.\n\n b. To the extent possible, if any provision of this Public License is\n deemed unenforceable, it shall be automatically reformed to the\n minimum extent necessary to make it enforceable. If the provision\n cannot be reformed, it shall be severed from this Public License\n without affecting the enforceability of the remaining terms and\n conditions.\n\n c. No term or condition of this Public License will be waived and no\n failure to comply consented to unless expressly agreed to by the\n Licensor.\n\n d. Nothing in this Public License constitutes or may be interpreted\n as a limitation upon, or waiver of, any privileges and immunities\n that apply to the Licensor or You, including from the legal\n processes of any jurisdiction or authority.\n\n\n=======================================================================\n\nCreative Commons is not a party to its public\nlicenses. Notwithstanding, Creative Commons may elect to apply one of\nits public licenses to material it publishes and in those instances\nwill be considered the “Licensor.” The text of the Creative Commons\npublic licenses is dedicated to the public domain under the CC0 Public\nDomain Dedication. Except for the limited purpose of indicating that\nmaterial is shared under a Creative Commons public license or as\notherwise permitted by the Creative Commons policies published at\ncreativecommons.org/policies, Creative Commons does not authorize the\nuse of the trademark \"Creative Commons\" or any other trademark or logo\nof Creative Commons without its prior written consent including,\nwithout limitation, in connection with any unauthorized modifications\nto any of its public licenses or any other arrangements,\nunderstandings, or agreements concerning use of licensed material. For\nthe avoidance of doubt, this paragraph does not form part of the\npublic licenses.\n\nCreative Commons may be contacted at creativecommons.org."
},
{
"path": "LICENSE-CODE",
"content": "The MIT License (MIT)\nCopyright (c) Microsoft Corporation\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and \nassociated documentation files (the \"Software\"), to deal in the Software without restriction, \nincluding without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, \nand/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, \nsubject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial \nportions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT \nNOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. \nIN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, \nWHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE \nSOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE."
},
{
"path": "README.md",
"content": "# Blazor Docs\n\nThe Blazor docs have moved to the https://github.com/aspnet/AspNetCore.Docs repo and are published at https://docs.microsoft.com/en-us/aspnet/core/blazor.\n\nFor an overview of the many projects being worked on by the Blazor community page check out the [Awesome Blazor](https://github.com/AdrienTorris/awesome-blazor) page.\n"
},
{
"path": "ThirdPartyNotices",
"content": "##Legal Notices\nMicrosoft and any contributors grant you a license to the Microsoft documentation and other content\nin this repository under the [Creative Commons Attribution 4.0 International Public License](https://creativecommons.org/licenses/by/4.0/legalcode),\nsee the [LICENSE](LICENSE) file, and grant you a license to any code in the repository under the [MIT License](https://opensource.org/licenses/MIT), see the\n[LICENSE-CODE](LICENSE-CODE) file.\n\nMicrosoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation\nmay be either trademarks or registered trademarks of Microsoft in the United States and/or other countries.\nThe licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.\nMicrosoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.\n\nPrivacy information can be found at https://privacy.microsoft.com/en-us/\n\nMicrosoft and any contributors reserve all others rights, whether under their respective copyrights, patents,\nor trademarks, whether by implication, estoppel or otherwise."
},
{
"path": "api/.gitignore",
"content": "###############\n# temp file #\n###############\n*.yml\n"
},
{
"path": "api/index.md",
"content": "---\ntitle: Blazor API\ndescription: Find information on the Blazor API.\nuid: api\n---\n# Blazor API\n\n[!INCLUDE[](~/includes/razor-components-preview-notice.md)]\n\nWelcome to the Blazor API area!\n\n## Namespaces\n\nUse the namespace links in the Table of Contents.\n"
},
{
"path": "appveyor.yml",
"content": "skip_tags: true\n\nimage: Visual Studio 2017\n\nclone_depth: 1\n\nbranches:\n only:\n - live\n\ninstall:\n - cinst docfx --version 2.40.7\n\nbuild_script:\n - docfx\n\ndeploy_script:\n - git config --global credential.helper store\n - ps: Add-Content \"$env:USERPROFILE\\.git-credentials\" \"https://$($env:GITHUB_ACCESS_TOKEN):x-oauth-basic@github.com`n\"\n - git config --global user.email %GITHUB_EMAIL%\n - git config --global user.name \"Blazor doc agent\"\n - bash releaseDocs.sh\n \n"
},
{
"path": "community.md",
"content": "# Blazor community resources\n\n[!INCLUDE[](~/includes/razor-components-preview-notice.md)]\n\nBelow is a list of projects and resources from the Blazor community (links in each section are alphabetical). If you know about a Blazor project that isn't listed, please let us know. We're happy to add it to the list.\n\n## Libraries\n\n* [BlazorBits](http://blazorbits.net) ([GitHub repo](https://github.com/blazorbits)) – Components including [Monaco editor](https://github.com/Microsoft/monaco-editor).\n* [BlazorComponents](https://github.com/muqeet-khan/BlazorComponents) – A demonstration of [Chart.js](https://github.com/chartjs/Chart.js) interop.\n* [BlazorConfirm](https://github.com/ctrl-alt-d/BlazorConfirm) ([Demo](https://ctrl-alt-d.github.io/BlazorConfirm/)) – A Blazor wrapper for JavaScript's `window.confirm()` and `onbeforeunload`.\n* [BlazorContextMenu](https://github.com/stavroskasidis/BlazorContextMenu) – A context menu for blazor.\n* [BlazorDB](https://github.com/chanan/BlazorDB) – In-memory, persisted to local storage, database for Blazor.\n* [Blazored.LocalStorage](https://github.com/blazored/LocalStorage) – A library to provide access to local storage in Blazor apps.\n* [Blazored.Menu](https://github.com/Blazored/Menu) – A JavaScript-free menu library for Blazor and Razor Components apps.\n* [Blazored.Modal](https://github.com/Blazored/Modal) – A JavaScript free modal library for Blazor and Razor Components applications.\n* [Blazored.Toast](https://github.com/Blazored/Toast) – A JavaScript free toast library for Blazor and Razor Component applications.\n* [Blazored.Localisation](https://github.com/Blazored/Localisation) – A library to provide localisation in client-side Blazor applications.\n* [BlazorEmbedLibrary](https://github.com/SQL-MisterMagoo/BlazorEmbedLibrary) – Provides Blazor-style embedded resources to Razor Components projects.\n* [BlazorWebSocketHelper](https://github.com/Lupusa87/BlazorWebSocketHelper) – A WebSocket library for Blazor.\n* [BlazorGrid](https://github.com/AnkitSharma-007/BlazorGrid) – Reusable grid component for Blazor, which also supports client side pagination.\n* [Blazorise](https://github.com/stsrki/Blazorise) ([Demo](https://bootstrapdemo.blazorise.com/)) – Components library for Blazor with support for Bootstrap, Bulma, and Material CSS.\n* [BlazorMaterial](https://github.com/BlazorExtensions/BlazorMaterial) – Blazor components implementing Google's Material components for web ([Material Design: Web](https://material.io/components/web)).\n* [BlazorNodaTimeDateTimePicker](https://github.com/nheath99/BlazorNodaTimeDateTimePicker) – A date picker using NodaTime.\n* [Blazorous](https://github.com/chanan/Blazorous) – Maintainable CSS with Blazor.\n* [BlazorScrollbar](https://github.com/Lupusa87/BlazorScrollbar) ([Demo](https://lupblazorscrollbar.z20.web.core.windows.net/)) – Reusable, fully configurable component with vertical and horizontal scrollbars.\n* [BlazorSignalR](https://github.com/csnewman/BlazorSignalR) – ASP.NET Core SignalR .NET client support for Blazor.\n* [BlazorSplit](https://github.com/BlazorComponents/BlazorSplit) ([Demo](https://blazorcomponents.github.io/BlazorSplit/)) – Resizeable split views.\n* [BlazorSplitter](https://github.com/Lupusa87/BlazorSplitter) ([Demo](https://lupblazorsplitter.z20.web.core.windows.net/)) – Reusable, fully configurable component with vertical and horizontal splitters and diagonal resizer.\n* [BlazorStorage](https://github.com/cloudcrate/BlazorStorage) – Blazor local and session storage support.\n* [BlazorStrap](https://github.com/chanan/BlazorStrap) – Bootstrap 4 Components for Blazor.\n* [BlazorTodos](https://lupblazortodo.z20.web.core.windows.net/) – Blazor todos demo app with registration, jwt authentication, email reminders and more, backed with Azure Storage Tables.\n* [BlazorVirtualGrid](https://github.com/Lupusa87/BlazorVirtualGrid) ([Demo](https://lupblazorvirtualgrid.z13.web.core.windows.net/)) – Reusable, fully configurable component with rows and columns fast virtualization.\n* [Blazor Barcode](https://barcoderesource.com/blazorbarcode.shtml) – A barcode library for Blazor using barcode fonts.\n* [Blazor Charts](https://github.com/Misfits-Rebels-Outcasts/Blazor-Charts) – SVG Charts for Blazor.\n* [Blazor Extensions Home](https://github.com/BlazorExtensions/Home) – Home for Blazor Extensions.\n* [Blazor Fluxor](https://mrpmorris.github.io/blazor-fluxor/) – Flux/Redux library.\n* [Blazor Gamepad](https://github.com/jsakamoto/Toolbelt.Blazor.Gamepad) – A library to provide gamepad API access for Blazor.\n* [Blazor Hotkeys](https://github.com/jsakamoto/Toolbelt.Blazor.Hotkeys) – A library to provide configuration-centric keyboard shortcuts for Blazor.\n* [Blazor LoadingBar](https://github.com/jsakamoto/Toolbelt.Blazor.LoadingBar) – A Blazor port of [angular-loading-bar](https://github.com/chieffancypants/angular-loading-bar).\n* [Blazor LocalFiles](https://github.com/jburman/W8lessLabs.Blazor.LocalFiles) – Open files in your browser and load into Blazor.\n* [Blazor Realm](https://dworthen.github.io/BlazorRealm/docs/quickstart.html) – Redux state management with middleware support.\n* [Blazor Redux](https://github.com/torhovland/blazor-redux) – This library offers Redux-style state management for Blazor.\n* [Blazor SpeechSynthesis](https://github.com/jsakamoto/Toolbelt.Blazor.SpeechSynthesis) – A library to provide Speech Synthesis API access for Blazor.\n* [Blazor SVG Helper](https://github.com/Lupusa87/BlazorSvgHelper) ([Demo](https://lupblazordemos.z13.web.core.windows.net)) – Create SVG elements with children (circle, rectangle, image, text, and others) and render with RenderTreeBuilder.\n* [Blazor Time Zone Kit](https://github.com/jsakamoto/Toolbelt.Blazor.TimeZoneKit) – A library to provide system time zones and local time zone initialization in Blazor apps.\n* [Blazor Tweet Button](https://github.com/jsakamoto/Toolbelt.Blazor.TwitterShareButton) – A Tweet Button component for Blazor.\n* [Blazor.Extensions.OfficeUIFabric](https://github.com/BlazorExtensions/Blazor.Extensions.OfficeUIFabric) – Microsoft Office Fabric UI port for Blazor.\n* [Blazor.FlexGrid](https://github.com/Mewriick/Blazor.FlexGrid) – GridView component for Blazor.\n* [Blazor.Payments](https://github.com/philipblaquiere/Blazor.Payments) – A library that replicates the [W3C Payment Request API](https://w3c.github.io/payment-request/) contracts in Blazor apps.\n* [Blazor.Polyfill](https://github.com/Daddoon/Blazor.Polyfill) – A Blazor compatibility library for Internet Explorer 11 and other browsers.\n* [Blazor.Xamarin](https://github.com/Daddoon/Blazor.Xamarin) – Host Blazor apps as standalone hybrid mobile apps with Xamarin.\n* [Blazor-State](https://timewarpengineering.github.io/blazor-state/) – Blazor-State is a client side pipeline architecture utilizing MediatR with plugin behaviors.\n* [Canvas](https://github.com/BlazorExtensions/Canvas) – HTML5 Canvas API implementation for Microsoft Blazor.\n* [ChartJs.Blazor](https://github.com/mariusmuntean/ChartJs.Blazor) – Blazor Component that wraps ChartJS.\n* [DevExpress Blazor UI Components](https://github.com/DevExpress/RazorComponents) – UI components including Data Grid, Pivot Grid, and several data editors.\n* [Elmah.Io.Blazor](https://github.com/elmahio/Elmah.Io.Blazor) – Logs from Blazor to [elmah.io](https://elmah.io/) using Microsoft.Extensions.Logging.\n* [Logging](https://github.com/BlazorExtensions/Logging) – Microsoft Extension Logging implementation for Blazor.\n* [MatBlazor](https://github.com/BlazorComponents/MatBlazor) ([Demo](https://blazorcomponents.github.io/MatBlazor/)) – Google Material components for web in Blazor.\n* [NObservable](https://github.com/kekekeks/NObservable) – MobX-like observables and component instrumentation.\n* [Notifications](https://github.com/BlazorExtensions/Notifications) – HTML5 Notifications API implementation for Microsoft Blazor.\n* [SignalR](https://github.com/BlazorExtensions/SignalR) – SignalR Core support for Microsoft ASP.NET Core Blazor.\n* [Sotsera.Blazor.Toaster](https://github.com/sotsera/sotsera.blazor.toaster) ([Demo](https://sotsera.github.io/sotsera.blazor.toaster/)) – A Blazor port of [Toastr.js](https://github.com/CodeSeven/toastr/).\n* [Storage](https://github.com/BlazorExtensions/Storage) – HTML5 Storage API implementation for Microsoft Blazor.\n* [Syncfusion Blazor UI Components](https://github.com/syncfusion/ej2-aspnet-core-blazor-samples) – A complete library of robust UI components including [Data Grid](https://ej2.syncfusion.com/aspnet-core-razor-components/Grid/DefaultFunctionalities), [Charts](https://ej2.syncfusion.com/aspnet-core-razor-components/Charts/polar), [Scheduler](https://ej2.syncfusion.com/aspnet-core-razor-components/Schedule/TimelineResourceGroup), [Inputs](https://ej2.syncfusion.com/aspnet-core-razor-components/TextBox/DefaultFunctionalities), and various [Editor](https://ej2.syncfusion.com/aspnet-core-razor-components/RichTextEditor/DefaultFunctionalities) components. \n* [Telerik UI for Blazor](https://www.telerik.com/blazor-ui) – A native set of UI components for Blazor, including grid, charting, and calendar components.\n* [Toastr](https://github.com/BlazorExtensions/Toastr) – A Blazor port of [Toastr.js](https://github.com/CodeSeven/toastr/).\n\n## Samples and tutorials\n\n* [A Nicer Looking Blazor Loading Page](http://lightswitchhelpwebsite.com/Blog/tabid/61/EntryId/4315/A-Nicer-Looking-Blazor-Loading-Page.aspx) – Customize the Blazor loading page using [SpinKit](https://github.com/tobiasahlin/SpinKit).\n* [ASP.NET Core Master/Detail CRUD](https://code.msdn.microsoft.com/vstudio/ASPNET-Core-Blazor-122b108a) – A master/detail HTML CRUD example with sorting and filtering using Entity Framework and Web API.\n* [BlazeDown](https://github.com/EdCharbeneau/BlazeDown) ([Demo](http://edcharbeneau.com/BlazeDown/)) – An online markdown editor built with Blazor.\n* [Blazing Chuck](https://davidpine.net/blog/blazing-chuck/) ([Demo](https://bit.ly/BlazingChuck)) – An example Blazor app that displays random \"nerdy\" Chuck Norris jokes.\n* [BlazorPass](https://github.com/ebekker/BlazorPass) – Blazor UI and ASP.NET Core API to manage Active Directory credentials.\n* [Blazor + Electron sample](https://github.com/aspnet/AspLabs/tree/master/src/ComponentsElectron) – Explore how a Blazor app can be used to build a cross-platform desktop app.\n* [Blazor + Sitecore](https://github.com/GoranHalvarsson/SitecoreBlazor) ([Blog post](https://visionsincode.wordpress.com/2018/06/30/time-travel-into-the-future-blazor-sitecore-helix/)) – Example of dynamic pages and routes with SiteCore and [Helix](https://helix.sitecore.net/).\n* [Blazor Admin Dashboard](https://github.com/Misfits-Rebels-Outcasts/Blazor-Dashboard) – An admin dashboard for Blazor.\n* [Blazor Asteroids](https://github.com/aesalazar/AsteroidsWasm) ([Demo](https://aesalazar.github.io/AsteroidsWasm/)) – The 80's classic video game developed in C# for WinForms/WPF but running Blazor.\n* [Blazor Bricks](https://www.codeproject.com/Articles/1241210/WebAssembly-with-Blazor) – A bricks game developed with C# and Blazor.\n* [Blazor Calculator](https://github.com/Lupusa87/BlazorCalculator) ([Demo](https://lupblazordemos.z13.web.core.windows.net/CalculatorPage)) – Simple calculator with history and ability to use previous results in new calculations.\n* [Blazor Calculator with Expressions](https://github.com/khaledmousa/BlazorCalculator) ([Demo](https://khaledmousa.github.io/)) – A sample numerical expression evaluator in Blazor utilizing an F# library that uses FsLex and FsYacc to parse expressions.\n* [Blazor Chat sample](https://github.com/conficient/BlazorChatSample) ([Demo](https://blazorchatsample.azurewebsites.net/)) – An app that demonstrates the use of [SignalR](https://docs.microsoft.com/aspnet/core/signalr/) to create a Blazor chat app.\n* [Blazor Chess](https://github.com/Lupusa87/BlazorChess) ([Demo](https://lupblazordemos.z13.web.core.windows.net/ChessPage)) – An experimental Blazor chess engine.\n* [Blazor Clock Canvas](https://github.com/Lupusa87/BlazorClockCanvas) ([Demo](https://lupblazordemos.z13.web.core.windows.net/ClockCanvas)) – Complex clock based on Canvas.\n* [Blazor Clock SVG](https://github.com/Lupusa87/BlazorClockSVG) ([Demo](https://lupblazordemos.z13.web.core.windows.net/)) – Complex clock based on SVG.\n* [Blazor Contoso University](https://github.com/lohithgn/blazor-contoso-university) – Contoso University recreated in Blazor.\n* [Blazor Converters](https://github.com/lohithgn/blazor-converters) ([Demo](http://blazorconverters.surge.sh)) – Windows 10 Calc Converters recreated in Blazor.\n* [Blazor Doughnut Chart](https://github.com/Lupusa87/BlazorDoughnutChartComponent) ([Demo](https://lupblazordemos.z13.web.core.windows.net/DoughnutChartpage)) – Doughnut charting with gradient colors using SVG.\n* [Blazor Examples](https://github.com/lohithgn/blazor-examples) ([Demo](http://blazorexamples.surge.sh/)) – Knockout JS examples recreated in Blazor.\n* [Blazor Game Snake](https://github.com/Lupusa87/BlazorGameSnake) ([Demo](https://lupblazordemos.z13.web.core.windows.net/GameSnakePage)) – 2D game snake with customizations, path finding algorithm, and sound effects using SVG.\n* [Blazor Graph API example](https://github.com/jburman/BlazorGraphExample) ([Demo](https://blazorgraph.z20.web.core.windows.net/)) – A self-contained Blazor app that connects to [Microsoft's Graph API](https://docs.microsoft.com/azure/active-directory/develop/active-directory-graph-api), queries the user's information, and allows the user to browse through their [OneDrive](https://onedrive.live.com/about/).\n* [Blazor Hacker News Clone](https://github.com/lohithgn/blazor-hackernews-clone) ([Demo](http://blazorhackernews.surge.sh/)) – A Hacker News clone built in Blazor.\n* [Blazor Loan Calculator](https://github.com/Lupusa87/BlazorLoanCalculator) ([Demo](https://lupblazordemos.z13.web.core.windows.net/LoanCalculatorPage)) – A loan payments calculator developed with Blazor.\n* [Blazor Paint](https://github.com/Lupusa87/BlazorPaint) ([Demo](https://lupblazordemos.z13.web.core.windows.net/PaintPage)) – Drawing app written in Blazor.\n* [Blazor Password Pattern](https://github.com/Lupusa87/BlazorPasswordPattern) ([Demo](https://lupblazordemos.z13.web.core.windows.net/PasswordPatternPage)) – Password pattern based on SVG.\n* [Blazor Performance Chart](https://lupblazordemos.z13.web.core.windows.net/PerformanceChartPage) – Performance Chart based on SVG.\n* [Blazor RealWorld example app](https://github.com/torhovland/blazor-realworld-example-app) – A full-stack app built with Blazor that includes CRUD operations, authentication, routing, and pagination.\n* [Blazor RSS Reader](https://github.com/lohithgn/blazor-rss-reader) ([Demo](https://blazorrssreader.surge.sh/)) – RSS Reader using Blazor.\n* [Blazor Spreadsheet](https://github.com/Lupusa87/BlazorSpreadsheet) ([Demo](https://lupblazordemos.z13.web.core.windows.net/SpreadsheetPage)) – Spreadsheet app developed in Blazor.\n* [Blazor Sushi](https://github.com/lohithgn/blazor-sushi) ([Demo](https://blazorsushi.surge.sh/)) – Kendo UI Sushi SPA recreated in Blazor.\n* [Blazor To-Do App](https://github.com/BorowskiKamil/blazor-tasks) – A Blazor app that allows you to create and edit tasks and manage categories of tasks.\n* [Blazor Tour of Heroes](https://github.com/lohithgn/blazor-tour-of-heroes) – A Blazor implementation of [Angular Tour of Heroes](https://angular.io/tutorial).\n* [Blazor UWP Sample](https://github.com/pushqrdx/Blazor.Universal) – Use Blazor.Server to build UWP apps.\n* [BlazorServiceWorker](https://github.com/roboriaan/BlazorServiceWorker) – A client-side Blazor template with service worker caching.\n* [Blazume](https://github.com/Amine-Smahi/Blazume) – A portfolio/resume template using Blazor.\n* [Bolero.TodoMVC](https://github.com/fsbolero/TodoMVC) – A TodoMVC clone using Bolero.\n* [CssBuilder](https://www.nuget.org/packages/BlazorComponentUtilities/) – A clean code approach to conditional CSS classes for Razor components in Blazor.\n* [Data Driven Layout](https://github.com/hutchcodes/Blazor.DataDrivenLayout) ([Blog post](https://hutchcodes.net/2018/09/data-driven-layout-in-razor-components/)) – Two ways of driving the layout based on data in the page.\n* [Do](https://github.com/jamie-lord/do) ([Demo](https://do.lord.technology)) – Todo.txt compatible todo app.\n* [FMRL](https://github.com/ebekker/FMRL) – Ephemeral Message Service. Messages sent are encrypted, securely transferred, and automatically deleted when they are retrieved.\n* [Money](https://github.com/maraf/Money) ([Demo](https://money.neptuo.com)) – A money manager implemented using CQRS+ES.\n* [Planning Poker for Azure](https://github.com/duracellko/planningpoker4azure) ([Demo](http://planningpoker.duracellko.net)) – An app to play [Planning Poker™](https://www.planningpoker.com) for distributed teams. The app is implemented using Blazor and shows how to switch between client-side and server-side mode with a configuration change. *Planning Poker* is a registered trademark of [Mountain Goat Software, LLC](https://www.mountaingoatsoftware.com/).\n* [Toss](https://github.com/RemiBou/Toss.Blazor) – A Twitter-like web app that allows the user to sign in, post a new message (a \"toss\") with hashtag, and select favorite hashtags for finding messages.\n* [TreeCRUD](https://github.com/ctrl-alt-d/TreeCrud) – A simple server-side Blazor CRUD app to deal with hierarchical data. The project has a data layer with GraphQL for R (Read) and classical REST for CUD (Create, Update, Delete).\n* [TrendTv](https://github.com/MattMarked/TrendTv) ([Demo](http://zaptube2.azurewebsites.net/)) – Fetch a video list from YouTube and \"zap\" in real time between trending videos, filtered by country or category.\n* [Try F# on WebAssembly](https://github.com/fsbolero/TryFSharpOnWasm) – The F# compiler running in WebAssembly with Bolero.\n* [Tzaar](https://github.com/paularundel/tzaar) ([Demo](https://tzaar.azurewebsites.net/)) – Implementation of the board game Tzaar with Blazor and SignalR. \n* [Quiz](https://github.com/Amine-Smahi/BlazorQuiz) – Simple quiz using Blazor.\n* [Validation Controls using Blazor](https://github.com/hishamco/BlazorValidationControls) – Blog posts: [Part I: Basic Validation Controls](http://www.hishambinateya.com/part1-validation-controls-using-blazor-basic-validation-controls) | [Part II: Custom Validation Controls](http://www.hishambinateya.com/part2-validation-controls-using-blazor-custom-validation-controls)\n* [WebSocketPage](https://github.com/Lupusa87/BlazorWebSocketHelper) ([Demo](https://lupblazordemos.z13.web.core.windows.net/WebSocketPage)) – WebSocket example for Blazor.\n\n## Tooling\n\n* [BlazorFiddle](https://blazorfiddle.com) – Blazor .NET developer playground and code editor in the browser.\n* [Blazor Minimum Project Templates](https://github.com/jsakamoto/BlazorMinimumTemplates) – A project templates package of Blazor apps without JavaScript and CSS libraries.\n* [Blazor Snippets Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=ScottSauber.blazorsnippets) – A Visual Studio Code extension that offers Blazor and Razor snippets.\n* [Razor+ Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=austincummings.razor-plus) – A Visual Studio Code extension that offers improved Razor support.\n\n## Community documentation\n\n* [Awesome Blazor](https://github.com/AdrienTorris/awesome-blazor) – A collection of useful Blazor resources.\n* [Blazor Bites](https://chrissainty.com/tag/blazor-bites/) – Posts on ASP.NET Core and Blazor subjects.\n* [Learn Blazor](https://learn-blazor.com/) – Community documentation on Blazor.\n* [LightSwitch Help Website](https://lightswitchhelpwebsite.com/Blog/tabid/61/tagid/66/Blazor.aspx) – Blogs and code samples primarily covering server-side Blazor (Razor Components).\n* [WebAssemblyMan](https://www.webassemblyman.com/) – Man page for Blazor and WebAssembly.\n\n## Books\n\n* [Blazor Revealed](https://www.apress.com/gp/book/9781484243428) – Build web apps in Microsoft .NET that run in any modern browser, helping you to transfer your .NET experience and skills to a new environment and build browser-based apps using a robust and type-safe language and runtime. \n* [Blazor Quick Start Guide: Build web applications using Blazor, EF Core, and SQL Server (2018)](https://amzn.to/2OToEji) – An introduction to Blazor core concepts and how to apply concepts to real-world web apps with the help of Entity Framework Core and SQL Server.\n* [Dockerizing ASP.NET Core and Blazor Applications on Mac](https://www.c-sharpcorner.com/ebooks/dockerizing-asp-net-core-and-blazor-applications-on-mac) – This book is targeted for beginning to intermediate .NET developers who want to jump into ASP.NET Core, Blazor, and Docker on macOS.\n\n## Courses\n\n* [Blazor First Look on LinkedIn Learning](https://www.linkedin.com/learning/blazor-first-look)\n* [Free Blazor Training Course](https://www.devexpress.com/support/training/blazor/)\n\n## Streams and podcasts\n\n* [Blazor StateHasChanged: The weekly community live show](https://www.youtube.com/edwardcharbeneau)\n\n## Other\n\n* [Bionic](https://bionicframework.github.io/Documentation) – An Ionic CLI clone for Blazor projects.\n* [Bolero](https://github.com/fsbolero/Bolero) – Blazor for F# with hot reloaded templates, type-safe endpoints and routing, remoting, and much more.\n"
},
{
"path": "docfx.json",
"content": "{\n \"metadata\": [\n {\n \"src\": [\n {\n \"files\": [\n \"src/**.dll\"\n ]\n }\n ],\n \"dest\": \"api\",\n \"disableGitFeatures\": false\n }\n ],\n \"build\": {\n \"content\": [\n {\n \"files\": [\n \"api/**.yml\",\n \"toc.yml\",\n \"**/*.md\"\n ],\n \"exclude\": [\n \"**/obj/**\",\n \"**/sample/**\",\n \"**/samples/**\",\n \"**/includes/**\",\n \"_site/**\"\n ],\n \"src\": \".\"\n }\n ],\n \"resource\": [\n {\n \"files\": [\n \"**/*.png\",\n \"**/*.jpg\"\n ],\n \"exclude\": [\n \"**/obj/**\",\n \"**/includes/**\",\n \"_site/**\"\n ],\n \"src\": \".\"\n }\n ],\n \"overwrite\": [],\n \"dest\": \"_site\",\n \"globalMetadataFiles\": [],\n \"fileMetadataFiles\": [],\n \"template\": [\n \"default\",\n \"template\"\n ],\n \"postProcessors\": [],\n \"noLangKeyword\": false,\n \"keepFileLink\": false,\n \"cleanupCacheHistory\": false,\n \"disableGitFeatures\": false,\n \"globalMetadata\": {\n \"_gitContribute\": {\n \"branch\": \"master\"\n }\n }\n }\n}\n"
},
{
"path": "docs/common/samples/3.x/BlazorSample/App.cshtml",
"content": "\n\n"
},
{
"path": "docs/common/samples/3.x/BlazorSample/BlazorSample.csproj",
"content": "\n\n \n netstandard2.0\n dotnet\n blazor serve\n 7.3\n \n\n \n \n \n \n \n\n\n"
},
{
"path": "docs/common/samples/3.x/BlazorSample/Components/ListViewTemplate.cshtml",
"content": "@typeparam TItem\n\n
\n @foreach (var item in Items)\n {\n @ItemTemplate(item)\n }\n