Starter Page

A template demonstrating available components. Copy this file to create new pages.

Component Docs

Starter Pages

Focused starter templates you can copy as a starting point for new pages.

Card Component

Cards are the primary content containers. They have a header and body section.

Use cards to group related content and create visual hierarchy on the page.

Left Column

Use CSS Grid for multi-column layouts.

Your content here

Right Column

Columns automatically stack on mobile.

More content here

Form Components

Help text appears below inputs
Click the calendar icon to pick a date
Combined date and time picker
Select a file to upload (any type)
Drag & drop an image or click to browse
Accepts JPG, PNG, GIF, WebP
Drag & drop a document or click to browse
Accepts PDF, DOC, DOCX, TXT

Button Styles

Link as Button

Buttons with Icons

Quick Links Pattern

Message Styles

Use Django's messages framework. Messages auto-dismiss after 5 seconds.

Success message — operation completed successfully!
Info message — here's some helpful information.
Warning message — please review before continuing.
Error message — something went wrong!

View & URL Setup

1. Create a view in config/views.py or your app's views.py:

def my_page_view(request):
    context = {'items': Item.objects.all()}
    return render(request, 'my_page.html', context)

2. Add URL pattern in config/urls.py or your app's urls.py:

from .views import my_page_view

urlpatterns = [
    path('my-page/', my_page_view, name='my_page'),
    # ... other urls
]

3. Add to the sidebar (optional) from your app's apps.py, so SmallStack's own templates stay untouched:

from django.apps import AppConfig


class MyAppConfig(AppConfig):
    name = "apps.myapp"

    def ready(self):
        from apps.smallstack.navigation import nav

        nav.register(section="main", label="My Page", url_name="my_page", order=10)