SoftinuxBase is a free, open source, and cross-platform framework with built-in security access support and management for creating modular and extendable ASP.NET Core Core web applications.

It is built using ExtCore framework and the most modern tools and languages. Join our team!

⚠️ During the pre-alpha development phase, the issues are managed in our bug tracker ⚠️

• It's free and open source.
• It runs on Windows, MacOS and Linux.
• It's completely modular and extendable. Using the features of the underlying ExtCore framework you can easily create your own extensions to extend its functionality.

• Project overview
  • Few Facts About SOFTINUX Base
  • Table of content
  • Basic Concepts
• License
• Getting started
  • Prerequisites
  • Installation
    • 1. Restore dependencies
    • 2. Restore nuget packages
    • 3. Update database with migration
    • 4. Build the application
    • 5. Run the app
      • ℹ️ Information About Visual Studio 2017 ℹ️
      • ℹ️ Information About Rider 2017.3 ℹ️
    • 6. Add the first user (demo user)
    • 7. Login with demo user
  • Implement your own extension
    • Add a new project
    • Add project reference to the solution
    • Write your code
• Browsers Support
• Using Visual Studio Code For Developing

SoftinuxBase is a framework that looks like a .NET Core web application, but is intended to host mini web applications called extensions. Every extension will plug its content (pages, menu items) as well as security and authentication related items (permissions, roles, links...).

SoftinuxBase manages the common stuff so that the developer can focus on its extension and business logic, just having to provide what we call metadata to know how to display and authorize access to content, and use our version of Authorize attribute.

Read documentation to learn more about this.

Some screenshots of features:

Licensed under the MIT License. See LICENSE file for license information.

In order you must have installed:

• .NET Core SDK version 2.2.
• Node JS

Run npm i command so that dependencies packages are installed.

Restore the nuGet packages is now an implicit command executed at application build. But you can still restore packages without building the application with the command dotnet restore in solution root folder.

Go to src/WebApplication folder and run dotnet ef database update. This will create the database. See appsettings.json for database path. The Entity Framework database context is defined in web application's Startup.cs. We use Sqlite for development, but you can change this easily for another SGDB (see appsettings.json file).

Go to the solution root folder and run bp.bat under Windows or bp.sh under Linux/MacOS. (use -h for help). This is the quick way. Some commands from bp.bat/bp.sh are also used by PreBuild and PostBuild events but this may not work for all IDEs.

Go to src/WebApplication folder and type dotnet run. If you prefer, you can also execute this command from solution root folder: dotnet run --project src\WebApplication\WebApplication.csproj (Beware of the path if you are on Linux/MacOS).

After that, the application is available on http://localhost:5000/ or https://localhost:5001/

If you launched application from Visual Studio, this port will change, being randomly defined, and value is stored in src/WebApplication/Properties/launchSettings.json You can edit this value in Visual Studio: WebApplication's properties > Debug tab > Web Server Settings/App URL or directly in launchSettings.json file. After, the default port used by dotnet run is the port defined in src/WebApplication/Properties/launchSettings.json.

Rider 2017.3 cannot execute the PostBuild event declared in src/WebApplication.csproj. You need to execute ./bp.sh copyexts and ./bp.sh copydeps after building the solution or project. Or refer to our documentation to see how to configure external tools that will be launched by build process.

With Postman (or the program of your choice) make a POST request to this url: http://localhost:5000/dev/seed/create-user With command line:

• using curl: curl -i -X POST http://localhost:5000/dev/seed/create-user -d "Content-Length: 0"
• using powershell: Invoke-WebRequest -Uri http://localhost:5000/dev/seed/create-user -Method POST

This will create the demo user with general permissions.

user: johndoe@softinux.com (or johndoe) password: 123_Password (password is case sensitive)

⚠️ You cannot place your Extensions folder to another drive. See #2981

You can use Visual Studio 2017, Visual Studio Code or JetBrains Rider to make your own extension. If you decide to use Visual Studio, be aware that projects are not compatible with Visual Studio 2015.

Using command-line (easy and cross-platform):

dotnet new classlib -o <you_new_project>

Go to solution folder and type:

dotnet add reference <path_to_your_new_project>

In your new project, create a class that implements SoftinuxBase.Infrastructure.IExtensionMetadata.

Your extension will depend on SoftinuxBase.Infrastructure.

Have a look at sample extensions, wiki, feel free to open issues for questions.

IE / Edge	Firefox	Chrome	Safari	Opera
IE10, IE11, Edge	last 10 versions	last 10 versions	last 10 versions	last 10 versions

If you prefer to use Visual Studio Code, you need these extensions:

Very recommended for this project

• Net Core Test Explorer
• C#
• Debugger for Chrome
• IntelliSense for CSS class name
• Path Intellisense
• ESLint
• Visual Studio Code Solution Explorer
• Visual IntelliCode
• Bracket Pair Colorizer
• EditorConfig for VS Code
• Rest Client
• Better Comments
• MarkdownLint
• Version Lens
• Trailing Spaces
• Todo
• Log File Highlighter

Optional for better experience:

• Git History
• Git Lens
• Git Graph
• gitignore
• HTML CSS Support
• Output Colorizer not maintained.
• Task Explorer
• Code Outline depreciated.Vs Code to this.
• TSLint
• Can I Use

At your discretion:

• To Do Task
• Remind Me
• Python
• Quokka.js

We also provide the tasks.json and launch.json configuration for Visual studio Code.